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revision bars along the margin of the page. 



Version Description 

2.2 March 1992 - Original printing. This document describes the software 
installation procedures for the Cray Research, Inc. (CRI) UNICOS 6.1.5 
release and the CRI entry-level (EL) systems IOS 9.1 release on Cray 
Research EL computer systems. 

2.3 June 1992 - This document has been reorganized and rewritten to 
describe the software installation procedures for the CRAY Y-MP EL 
system software 2.3 release. The 2.3 release consists of the Cray 
Research UNICOS 6.1.6 release and the Cray Research entry-level (EL) 
systems IOS 9.3 release software. 

7.0 February 1993 - This document describes the software installation 

procedures for the UNICOS 7.0 release and the IOS 10.1 release on 
CRAY Y-MP EL computer systems. 
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Preface 



This publication is for system administrators and operators of 
CRAY Y-MP EL systems. It provides the procedures that are 
necessary to accomplish the following: 

• Boot the preinstalled CRAY Y-MP EL system software 

• Upgrade to a new release of the CRAY Y-MP EL system 
software 

• Reinstall the CRAY Y-MP EL system software 

This guide also provides information on customizing your 
configuration and performing basic troubleshooting procedures. 



Related 
publications 



Because CRAY Y-MP EL systems run the UNICOS operating 
system, you will find the entire UNICOS manual set to be 
helpful. However, because some differences exist that are 
especially important to system administrators and operators, the 
following Cray Research, Inc. (CRI) publications help you run 
UNICOS successfully on CRAY Y-MP EL systems: 

• UNICOS Release Overview for CRAY Y-MP EL Systems, 
publication RO-5200 

• CRAY Y-MP EL System-specific Administrator Commands 
Reference Manual, publication SG-2408 

• CRAY Y-MP EL Basic Administration Guide, publication 
SG-2416 

• A Brief Overview of Your Cray Research Entry -level (EL) 
Computer System, publication SG-2410 
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• CRAY Y-MP EL Computer Systems Online Diagnostic 
Maintenance Manual, publication SPM-1025' 



Conventions This manual uses the following typographical conventions: 

Convention Meaning 

typewriter font Denotes literal items such as command 

names, file names, routines, directory names, 
path names, signals, messages, and 
programming language structures. 

italic font Denotes variable entries and words or 

concepts being defined. 

bold typewriter font 

In screen drawings of interactive sessions, 
denotes literal items entered by the user. 
Output is shown in nonbold typewriter font. 

[ ] Brackets enclose optional parts of a command 

line. 

< > Angle brackets indicate that you must use at 

least one of the enclosed options. 

In this publication, Cray Research, CRI, and Cray refer to Cray 
Research, Inc. and/or its products. To avoid redundancy or 
awkwardness, Cray Research may occasionally be shortened to 
Cray (for example, Cray disk or Cray job). 



f CRAY RESEARCH PROPRIETARY. Dissemination of this 
document to non-CRI personnel requires approval of the 
appropriate vice president and that the recipient sign a 
nondisclosure agreement. Export of technical information 
in this category may require an export license. 
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Preface 



Ordering The User Publications Catalog, publication CP-0099, lists all 

mihlieations Cray Research hardware and software manuals that are 

^ available to users. 

To order a manual, either call the Distribution Center in 
Mendota Heights, Minnesota, at (612) 681-5907 or send a 
facsimile of your request to fax number (612) 681-5920. Cray 
Research employees may choose to send electronic mail to 
order . desk (UNIX system users) or order desk (HPDesk 
users). 



Reader comments If y° u have comments about the technical accuracy, content, or 

organization of this manual, please tell us. You can contact us in 
any of the following ways: 

• Send us electronic mail from a UNICOS or UNIX system, using 
the following UUCP address: 

uunet ! cray ! publications 

• Send us electronic mail from any system connected to Internet, 
using the following Internet addresses: 

pubs 5 2 01@timbuk . cray . com (comments specific to this 
manual) 

publications@timbuk . cray . com (general comments) 

• Contact your Cray Research representative and ask that a 
Software Problem Report (SPR) be filed. Use PUBLICATIONS 
for the group name, PUBS for the command, and NO-LICENSE 
for the release name. 

• Call our Software Information Services department in Eagan, 
Minnesota, through the North American Support Center, 
using either of the following numbers: 

(800) 950-2729 (toll free from the United States and 
Canada) 

(612) 683-5600 
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• Send a facsimile of your comments to the attention of 
"Software Information Services" in Eagan, Minnesota, at fax 
number (612) 683-5599. 

• Use the postage-paid Reader's Comment form at the back of 
this manual. 

We value your comments and will respond to them promptly. 
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Overview [1] 



This document is for system administrators and operators of 
CRAY Y-MP EL computer systems. It explains the procedures for 
booting the preinstalled CRAY Y-MP EL system software 7.0 
release. This guide also provides information about how to 
upgrade to a new revision level of the CRAY Y-MP EL system 
software and how to reinstall the software from tape. 

There are several noteworthy changes in release 7.0 for 
CRAY Y-MP EL systems. A new package format includes absolute 
binary files instead of the relocatable files that were shipped in 
previous releases. The following are the effects of this change: 

• Absolute binaries are loaded from the package directly into the 
root (/) and /usr file systems instead of relocatable binaries 
being loaded into /usr/src to be linked with segldr and 
cpset into their destinations. The exception to this is the 
UNICOS kernel build environment, which is still delivered into 
/usr/src/uts. 

• The time required to install a UNICOS package has been 
substantially reduced because no builds are necessary except 
for the UNICOS kernel. 

• The amount of space required for /usr/src has been 
substantially reduced. The recommended default is now 
50,000 blocks. 

• The minimum space required for the root (/) and back-up root 
(/bkroot) file systems is 90,000 blocks. 

• The minimum space required for the /usr and back-up /usr 
(/bkusr) file systems is 150,000 blocks. 

• The UNICOS Installation and Configuration menu system (the 
menu system) has limited support in this release. You can use 
the menu system to install MLS, but you cannot use it to 
install UNICOS on CRAY Y-MP EL systems. See "UNICOS 
Configuration Menu System," page 123, for information about 
using the menu system. 
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A version of the CRAY Y-MP EL system software is installed and 
configured on your CRAY Y-MP EL system. The software consists 
of the CRAY Y-MP EL I/O subsystem (IOS) and the Cray Research 
UNICOS operating system. 

Before you begin any of the procedures outlined in this guide, 
you should read through the section that relates to the procedure 
you intend to perform. For example, if you intend to use the 
preinstalled software, you should read "Booting Preinstalled 
UNICOS," page 5, in its entirety before beginning the procedures. 

You should have available the following documentation: 

• CRAY Y-MP EL Basic Administration Guide, publication 
SG-2416 

• UNICOS User Commands Reference Manual, publication 
SR-2011 

• CRAY Y-MP EL System-specific Administration Commands 
Reference Manual, publication SR-2408 

• UNICOS Administrator Commands Reference Manual, 
publication SR-2022. 



Unless you are upgrading to a new release level or intend to 
reinstall the CRAY Y-MP EL system software (UNICOS), you 
should follow the procedures in "Booting Preinstalled UNICOS," 
page 5, for booting the preinstalled UNICOS. 

"Upgrade Installation," page 45, is for sites currently running 
UNICOS which plan to upgrade to a new release level. 

"Reinstalling UNICOS," page 57, explains how to perform an 
initial installation of UNICOS from tape. 

Appendixes A through G provide information on the following: 

• Online tape system 

• Panics and file system crashes 

• Console terminal settings 

• Disk array subsystem (DAS) 

• UNICOS multilevel security (MLS) 

• Configuring network interfaces 



Organization 

l.i 
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• Configuring network interfaces 

• UNICOS Installation and Configuration Menu System 



After your CRAY Y-MP EL system is powered up, you must 
manually reset both the IOS and central processing unit (CPU) 
logic before booting the preinstalled UNICOS system or installing 
it from tape. If you are upgrading to a new revision level of 
UNICOS on a CRAY Y-MP EL system, you do not need to reset the 
IOS and CPU logic. 

To reset both the IOS and CPU logic, depress the two manual 
reset buttons on the front panel of your CRAY Y-MP EL system. 
Figure 1 shows this panel. 




A 



Before you begin 

1.2 



Figure 1. CRAY Y-MP EL system front-panel configuration 
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Section 4 of the UNICOS Release Overview for CRAYY-MP EL 
Systems, publication RO-5200, outlines software compatibility 
issues and differences between previous EL releases and the 
UNICOS 7.0 release. Before proceeding with the upgrade to 
UNICOS 7.0, you should familiarize yourself with this 
information. 
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Booting Preinstalled UNICOS [2] 



This section describes the procedures for booting the preinstalled 
CRAY Y-MP EL system software that is configured to match the 
hardware configuration of your CRAY Y-MP EL system. 

The preinstalled UNICOS file systems let you run UNICOS with a 
generic file system configuration. You may decide to reconfigure 
the file systems to match your site requirements and disk space. 
The procedures to make these changes are outlined in this 
section. 



Loading the IOS When your system is powered up, you will see the programmable 

kernel read-only memory (PROM) prompt, BOOT>, on your system 

2 1 console. At this prompt, enter the following command to boot 

the preinstalled IOS kernel: 

BOOT> load 

Output similar to that shown on the following page is displayed 
on your system console when the IOS kernel is loaded. The 
length of time required for the load command to execute 
depends on the number of IOSs and devices that are configured 
on your CRAY Y-MP EL system. After the IOS kernel is loaded 
successfully, your prompt will change from BOOT> to IOS>. 
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BOOT> load 
Loading /IOS/IOS... 

Loaded 200422 bytes to location 0x3010000. 
RC> call 03010020 

IFX Version 1.10 

RTSCOPE 68020 vl.24 

No FPU Present 



Copyright (c) 1991, 1992, 1993 by Entry Level Systems, Cray Research, 
Inc. This is confidential and proprietary software. 
All rights reserved. 



Entry Level Systems IOS version 10.1 93/01/29 11:36:36 

SCSI Winchester disk: 1 drive (s) found 
Master IOS: IOP Serial Number 1509 
VME SCSI: Controller 0 - detected 
Ethernet: Controller 0 - detected 



ESDI 


ctlr 


0 


unit 


0 


[E00] , 


type = DD3 




ESDI 


ctlr 


0 


unit 


1 


[EOl] , 


type = DD3 




ESDI 


ctlr 


1 


unit 


0 


[E10] , 


type = DD3 




ESDI 


ctlr 


1 


unit 


1 


[Ell] , 


type = DD3 




DAS 


ctlr 


0 


bank 


0 


[D00] , 


type = DDAS2 




SCSI 


ctlr 


0 


unit 


0 


lun 0 


[rssOOO], type = 


TD3 


SCSI 


ctlr 


0 


unit 


1 


lun 0 


[rssOlO] , type = 


TD3S 


SCSI 


ctlr 


IOP unit 


1 lun 


0 [rpqOl] , type = 


QT1 


SCSI 


ctlr 


IOP unit 


2 lun 


0 [rpe02] , type = 


EX2 



PERTEC ctlr 0 unit 0 [rmtOO] , type = TD2 
PERTEC ctlr 1 unit 0 [rmtlO] , type = TD2 

Architecture: YMP-EL, cpu 0 configured. 
This is the MASTER IOS. 




IOS> 
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Setting the IOS ^° verify that the IOS clock is set for your local date and time 

clock an( * ^° a( ^ us * ^ s c l° c k> use the time command, as follows: 



2.2 



IOS> time 

The time reported and set by this command is the time that 
UNICOS will boot with; therefore, be sure it is correct, so you do 
not have to change it later for UNICOS and then have your 
UNICOS clock be out of sync with your IOS clock. 

For more information on the time command, see the 
CRAY Y-MP EL System-specific Administration Commands 
Reference Manual, publication SR-2408. 



Booting UNICOS Th e UNICOS kernel (/ sys /unicos . ymp) and configuration file 

2.3 ( / sys / conf ig . uni) reside on the IOS Small Computer System 

Interface (SCSI) disk device. These files are used within the 
boot script when booting the system to single-user mode. This 
method provides flexibility to change variables such as ROOTDEV 
and PIPEDEV from the IOS prior to booting the UNICOS system. 

With the IOS kernel loaded, boot UNICOS to single-user mode by 
entering the following command at the IOS> prompt: 

IOS> boot 

After booting UNICOS to single-user mode, you must use the 
f sck command to check the root (/) file system for 
inconsistencies. See UNICOS System Administration, 
publication SG-2113, for information about the f sck command. 

After successfully correcting the /root file system, f sck prints 
the number of files on the /root file system, the number of used 
and free blocks, and the percentage of fragmentation. To check 
the /root file system, enter the following command line at the 
UNICOS prompt (#): 

# fsck /dev/dsk/root 



Note 

IcoNTROL-a] toggles between the IOS and UNICOS consoles. 
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This subsection describes how to configure your peripherals by 
editing your configuration specification language (CSL) variables 
in the /sys/conf ig.uni file that resides on the IOS disk. 

Using CSL, you will define run-time system configurable 
variables, your disk peripherals, and file systems. 

To familiarize you with CSL, this subsection provides an 
overview, which includes a description of CSL, parameter setting 
recommendations, and a sample configuration file. "Modify the 
parameter file conf ig.uni," page 18, describes the specific 
procedures for editing and reinstalling your new 
/ sys / conf ig . uni file. See UNICOS System Administration, 
publication SG-2113, for more information about CSL. 



Configuring disk 
space 

2.4 



Note 

System performance is significantly impacted by disk 
configuration. See UNICOS System Administration, publication 
SG-2113, for details about file system placement. 



Configuration CSL describes configuration and run-time parameter settings 

specification language that are interpreted when you boot UNICOS. The use of CSL 

( CSL) overview statements permits you to extend or override the default 

2.4.1 configuration by letting you do the following: 

• Define the physical attributes of your disk devices 

• Define the logical grouping of your physical disk slices 

• Define system devices 

• Configure logical device cache 

• Define memory size (required) 

• Specify the number of IOSs, CPUs, and channels 

Your IOS /sys/conf ig.uni file contains the definitions of your 
physical and logical system disk devices. Optionally, 
sys/conf ig.uni can contain CSL statements to modify or 
override specific UNICOS kernel parameters and the additional 
statements required to configure UNICOS disk striping. 
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Each time the UNICOS operating system is booted, UNICOS 
interprets and sequentially processes the CSL statements; 
therefore, the order of your CSL statements is very important. 
After processing the CSL file, UNICOS automatically creates the 
following parameter files that reflect the current system 
configuration: 

File name Description 

/ IOS-param This file is an exact copy of your CSL 

file. 

/CONFIGURATION This file contains CSL-defined 

definitions and compiled UNICOS 
kernel definitions. 

/unicos This file is a copy of the running 

UNICOS kernel. 



CSL recommendations When configuring UNICOS during the installation process, you 

2.4.2 must use CSL to define the size and location of the disk region 

used for the root (/), /usr, and /usr/src file systems. You 
must also use CSL to define the size and location of the UNICOS 
swap and dump devices, /bkroot (back-up root), /bkusr 
(back-up /usr), /tmp, and /core. 



Note 

Disk and buffer memory resident (BMR) partitions are defined in 
units of blocks (1 block = 4096 bytes) on CRAY Y-MP EL systems. 



Balancing I/O To balance your I/O, place the root (/) and /usr file systems on 

2.4.2.1 different disk drives. If possible, also isolate the root (/) and 

/usr file systems on different disk controllers. The 
recommended disk drive for the root (/) and /usr file systems is 
the DD-4 disk drive; use the DD-3 and DDESDI disk types as 
alternatives. 
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Defining the root (/), 
/usr, and /usr/src file 
systems 
2.4.2.2 



You must define the root (/) and back-up root (/bkroot) file 
systems as the same size; they require a minimum of 90,000 
blocks. You must also define the /usr and back-up /usr 
(/bkusr) file systems as the same size; they require a minimum 
of 150,000 blocks. 

The disk space requirements for /usr/src on CRAY Y-MP EL 
systems have been dramatically reduced for the UNICOS 7.0 
release. The recommended default value is 50,000 blocks. This 
is sufficient to hold all of the files necessary to relink UNICOS 
kernels and to build the CF77 and SCC compilers. Table 1 shows 
the required disk space in /usr/src for UNICOS and other 
products on CRAY Y-MP EL systems: 



Table 1. Disk space on /usr/src required for UNICOS and 
other products 



Product 



Size in 4 Kbyte blocks 



UNICOS 7.0 25,000 

CF77 5.0 11,500 

SCC 3.0 9,500 

Pascal 4.2 2,300 

Data migration 15,400 

DWB 9,100 

OSI 2.0 44,700 



Configuring the swap Generally, you shou ld coiifiguxaxcanLS^an device to be _.3 to 8 

device tjme sJarger thar LyjairJINTCOS main memory If your system 

2.4.2.3 includes a disk array subsystem (DAS), use it for your swap 

device, because the DAS is best suited for large-block sequential 
I/O. The DAS is also an excellent location for seldom-used file 
systems or application disk space. 
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If you have no DAS, configure your swap device on available 
DD-4 or DD-3 disk drives. Locate your swap device on different 
disk drives than those used for your user's /home directories and 
applications. 



Configuring stripe groups Stripe group members must be placed on the same disk type (for 
2.4.2.4 example, DD-4), be the same length, and start at the same block. 

When possible, place stripe group members on separate 
controllers. You can also stripe across multiple IOSs. 

A striped swap configuration example of stripe_20 and 
stripe_30 on IPI disk drives follows: 



STRIPED := DDSTR ( 

stripe_20 + stripe_30 /* 150000 blocks 

*/ 
) ; 

swap := ( /* 150000 blocks 

*/ 

stripe_2 0 

) ; 



When using a BMR device, you should adhere to the following 
rules: 

• Striped file systems cannot contain BMR partitions. 

• Banded file systems (physically adjacent file systems on a 
disk) can be composed of BMR partitions from more than one 
IOS. 

• BMR and disk partitions can be mixed in file systems that are 
not striped. 

• The swap device can be defined to include partitions of BMR 
from more than one IOS. 

• A BMR device defined as ldcache can be used only to cache 
file systems that are wholly composed of disk partitions that 
reside within the same IOS as that BMR device. 

• The CSL BMRDEV statement cannot be defined to include 
partitions of a BMR device from more than one IOS. 



Using a buffer memory 
resident (BMR) device 
2.4.2.5 
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Disk types Table 2 shows the disk types that can be configured on your 

2.4.3 CRAY Y-MP EL system: 



Table 2. CRAY Y-MP EL system disk types 



Disk type 


Description 


Number of 
user blocks 
per device 


Sectors/ 
track 


DDESDI 


Old ESDI drive 


170,100 


9 


(,!«,, ^ DD-3 


New ESDI drive 


334,200 


10 


DR-1 


Removable ESDI 


334,200 


10 




IPI-Sabre 7 


653,000 


28 


DDLDAS 


Old DAS 


1,269,114 


65 


DDAS2 


New DAS 


2,502,000 


75 


DDBMR 


VME RAM device 


Multiple of 
32,768 




DDRAM 


Central memory 
resident 


Configuration 
dependent 





Sample CSL settings The sample / sys /conf ig . uni file, beginning on page 13, 

2.4.4 contains CSL for a CRAY Y-MP EL system with two CPUs and two 

IOSs. This file exemplifies a configuration for the basic file 
systems and 10 sample file systems (fsl...fsl0). Each file 
system name has a suffix of _dxyz, where each letter has the 
following meaning: 

Component Meaning 

d Device type 

x IOS number 

y Controller number 

z Unit number 
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For clarity, the sample / sys /conf ig . uni file is partitioned by 
text that explains each configurable parameter. CSL comments 
start with "/*" and end with "*/". 



CONFIG { 

AUTOGEN OFF; 

/* ios settings */ 

/* The number of IOSs must be set if more than 1. CHANNEL sets */ 
/* channel number for IOSs beyond IOS 0. */ 

IOS=2; 

CHANNEL 040 = MIOP IOS = 1; 

/* CPU settings */ 

/ * The number of CPUs must be set if more than 1 . * / 
CPUS = 2; 

/* NLDCH is the number of ldcache headers. LDCHCORE is the number */ 
/* of 4 -Kbyte blocks of type MEM ldcache. */ 

/* NLDCH = 1024; */ 

/* LDCHCORE = 8192; */ 

/* */ 

/* IOS 0 physical devices settings */ 

/* _ */ 

/* IOS 0 ESDI controller (MIOP) 0 */ 

ESDI_000 := DD3 MIOP 0 UNIT=0 ( 

0:root_e000 /* 90000 blocks */ 

96000:fsl_e000 /* 244200 blocks */ 

) ; 

(continued) 
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ESDI_001 := DD3 MIOP 0 UNIT=1 ( 

0:fs2_e001 /* 184200 blocks */ 

184200 :tmp_e001/* 150000 blocks */ 

) ; 

ESDI_002 := DD3 MIOP 0 UNIT=2 ( 

0:fs3_e002 /* 184200 blocks */ 

1842 00 :tmp_e0 02/* 150000 blocks */ 

) ; 

ESDI_003 := DD3 MIOP 0 UNIT=3 ( 

0:fs4_e003 /* 184200 blocks */ 

184200 :tmp_e003/* 150000 blocks */ 

) ; 

/* IOS 0 ESDI controller (MIOP) 1 */ 

ESDI_010 := DD3 MIOP 1 UNIT=0 ( 

0:usr_e010 /* 150000 blocks */ 

150000 :src_e010/* 150000 blocks */ 
300000:fs4_e010/* 34200 blocks */ 

) ; 

ESDI_011 := DD3 MIOP 1 UNIT=1 ( 

0:fs3_e011 /* 184200 blocks */ 

184200: tmp_e011/* 150000 blocks */ 

) ; 

ESDI_012 := DD3 MIOP 1 UNIT=2 ( 

0:fs2_e012 /* 184200 blocks */ 

184200 :tmp_e012/* 150000 blocks */ 

) ; 

ESDI_013 := DD3 MIOP 1 UNIT=3 ( 

0:fsl_e013 /* 184200 blocks */ 

184200 :tmp_e013/* 150000 blocks */ 

) ; 

/* IOS 0 DAS controller (MIOP) 8 */ 
/* Note: DAS MIOPs are referenced as MIOP 8 */ 

DAS_000 := DDAS2 MIOP 8 UNIT=0 ( 

0:dump_d000 /* 75000 blocks */ 

75000 :swap_d000 ■/* 350000 blocks */ 
425000 :bkroot_d000 /* 90000 blocks */ 

(continued) 
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515000 :bkusr_d000 /* 150000 blocks */ 
665000:core_d000 /* 150000 blocks */ 

815000 :local_d000 /* 250000 blocks */ 
1065000 :tmp_d000 /*1470000 blocks */ 

) ; 

/* */ 

/* IOS 1 Physical devices settings */ 

/* */ 

/* IOS 1 IPI controller (MIOP) 10 */ 
/* Note: IPI MIOPs are referenced as MIOP 10 */ 

IPI_100 := DD4 MIOP 10 UNIT=0 IOS=l ( 

0:fs5_il00 /* 653000 blocks */ 

) ; 

IPI_101 := DD4 MIOP 10 UNIT=1 IOS=l ( 

0:fs6_il01 /* 653000 blocks */ 

) ; 

IPI_102 := DD4 MIOP 10 UNIT=2 IOS=l ( 

0:fs5_il02 /* 653000 blocks */ 

) ; 

IPI_103 := DD4 MIOP 10 UNIT=3 IOS=l ( 

0:fs6_il03 /* 653000 blocks */ 

) ; 

/* IOS 1 ESDI controller (MIOP) 0 */ 

ESDI_100 := DD3 MIOP 0 UNIT=0 IOS=l ( 

0:fs7_el00 /* 334200 blocks */ 

) ; 

ESDI_101 := DD3 MIOP 0 UNIT=1 IOS=l ( 

0:fs8_el01 /* 334200 blocks */ 

) ; 

ESDI_102 := DD3 MIOP 0 UNIT=2 IOS=l ( 

0:fs9_el02 /* 334200 blocks */ 

) ; 

ESDI_103 := DD3 MIOP 0 UNIT=3 IOS=l ( 
0:fsl0_el03 /* 334200 blocks */ 

) ; 

/* Stripe groups */ 



(continued) 
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Logical device settings 



/ 



■*/ 

-*/ 

■*/ 



dump : = ( 
dump_d000 

) ; 

swap : = ( 
swap_dO 0 0 

) ; 

bkroot : = ( 
bkroot_d000 

) ; 

bkusr : = ( 
bkusr_d000 

) ; 

core := ( 
core_d000 

) ; 

local := ( 
local_d000 

) ; 

dastmp := ( 
tmp_d000 

) ; 

fs5 := ( 
fs5_il00 
fs5_il02 

) ; 

fs6 := ( 
fs6_il03 
fs6_il01 

) ; 

root : = ( 

root_e000 

) ; 

usr : = ( 

usr_e010 

) ; 

src : = ( 

src_e010 

) ; 



/* 75000 blocks */ 

/* 163840 blocks */ 

/* 90000 blocks */ 

/* 150000 blocks */ 

/* 150000 blocks */ 

/* 250000 blocks */ 

/*1470360 blocks */ 
/* 1306000 blocks */ 

/* 1306000 blocks */ 

/*90000 blocks */ 
/* 150000 blocks */ 
/*150000 blocks */ 



(continued) 
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tmp := ( /* 900000 blocks */ 

tmp_e001 
tmp_e011 
tmp_e002 
tmp_e012 
tmp_e003 
tmp_e013 

) ; 

fsl := ( /* 422400 blocks */ 

fsl_e000 
fsl_e013 

) ; 

fs2 .-= ( /* 368400 blocks */ 

fs2_e012 
fs2_e001 

) ; 

fs3 := ( /* 368400 blocks */ 

f s3_e002 
fs3_e011 

) ; 

fs4 := ( /* 218400 blocks */ 

fs4_e010 
fs4_e003 

) ; 

fs7 := ( /* 334200 blocks */ 

fs7_el00 

) ; 

fs8 := ( /* 334200 blocks */ 

fs8_el01 

) ; 

fs9 := ( /* 334200 blocks */ 

fs9_el02 

) ; 

fslO := ( /* 334200 blocks */ 

fsl0_el03 

); 

I * * i 

/* System devices */ 

/* */ 

SWAPDEV = swap; 
ROOTDEV = root; 
PIPEDEV = root; 
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Modify the 
parameter file 
conf ig.uni 

2.5 



If you want to change your system's disk configuration, use the 
following procedure: 

1. Make a back-up copy of your current conf ig . uni file by 
using the following command 

install* |coNTROL-a] (toggles to the IOS) 

IOS> cp /sys/conf ig.uni /sys/conf ig.bak 

2. Transfer the /sys/conf ig.uni file from the IOS to UNICOS 
by entering the following: 

IOS> |coNTROL-a1 |return| (toggles back to UNICOS) 
install* exdf -i sys/conf ig.uni > new_config 

3. Edit the /new_conf ig file to match your configuration by 
entering the following: 

install* vi /new_config 

4. Check the configuration file for errors by entering the 
following: 

install* bconfig new_config 

5. If no errors are found, write the file back to the IOS SCSI 
disk, as follows: 



Caution 



The following command line overwrites the CSL file on the IOS 
hard disk that was used when UNICOS was previously booted. 



install* exdf -o sys/conf ig.uni < new_config 

6. Reboot using the new configuration, as follows: 

install* sync; sync; sync 

IcoNTROL-al (toggles to the IOS) 
IOS> 

IOS> reload (wait for the IOS load to finish) 
IOS> /bin/boot 
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7. Create the mount table, then check and mount the /usr 
and/usr/src file systems by entering the following 
commands: 

# /etc/devnm / | /etc/setmnt 

# /etc/fsck /dev/dsk/usr 

# /etc/mount /dev/dsk/usr /usr 

# /etc/fsck /dev/dsk/src 

# /etc/mount /dev/dsk/src /usr/src 

8. Use the mkf s command to check any new file systems and to 
recreate file systems that have changed size due to the new 
configuration. 



Relink the UNICOS You can relink a UNICOS kernel for reasons that are specific to 
kernel your site. When you relink a UNICOS kernel, you can modify the 

2 g following kernel configuration files (SN is your system's serial 

number): 

• /etc/conf ig/conf ig .mh 

• /usr/src/uts/cf .SN/sn . h 

• /usr/src/uts/cf .SiV/conf . c 

• /usr/src/uts/cf .SiV/config .h 

This subsection provides procedures for relinking a UNICOS 
kernel, lists examples of the kernel configuration files, and tells 
how they can be modified. 



Relinking procedures Use the following procedures to relink the UNICOS kernel: 

2.6.1 

1. Before starting this procedure, the UNICOS system must be 
in single-user mode with the root (/), /usr, and /usr/src 
file systems mounted. (The state it is in after completing 
"Modify the parameter file conf ig.uni," page 18.) 
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2. Ensure that the sn . h, conf . c, and 

/ etc /conf ig/conf ig.mh files are correct (see examples on 
pages 21 through 42), and relink the kernel by entering these 
commands: 

# cd /usr/src/uts 

# /usr/bin/nmake rmbin rmexe 

# /usr/bin/nmake install 

3. Save the old kernel and move the new kernel to the IOS disk 
by entering the following: 

# cd /usr/src/uts/cf .SN 

# |C0NTR0L-a1 (toggles to the IOS console) 

IOS> mv /sys/unicos .ymp /sys/unicos . old 

I control -al IreturnI (toggles back to the UNICOS console) 

# /bin/exdf -o sys/unicos .ymp < unicos 

4. Reboot the system by entering the following: 

# cd / 

# /etc/umountem 

# sync; sync; sync 

# I control -al (toggles to the IOS console) 

IOS> boot (boots UNICOS to single-user mode) 



Caution 

Booting the kernel without first reloading the IOS will not work 
if you have run UNICOS in multiuser mode or have started any 
of the network interfaces. 



Example configuration This subsection lists examples of the kernel configuration files, 
files and tells how they can be modified. The serial number 5102 is 

2.6.2 used for example purposes; yours will be different. The dates, 

times, and version numbers shown here may also be different 
from the ones in the files on your system. 
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sn . h configuration file 
2.6.2.1 



The following example shows the lines in the 
/usr/src/uts/cf . 51 02 /sn.h configuration file that you can 
safely change. You can change the serial number (SN), the 
number of CPUs (NCPU), and the memory size (MEMORY). (Your 
/usr/src/uts/cf . 5102 /sn.h file can begin as a copy of the 
/usr/src/uts/cl/sys/sn. 5102 .hfile.) 



#define SN 
# define NCPU 
# define MEMORY 



5102 
4 

128*MEGAWD-1 



/* mainframe serial number */ 

/* Number of CPUs */ 

/* memory size in words */ 



conf . c configuration file The following example shows the part of the 

2.6.2.2 /usr/src/uts/cf . 5102 /conf . c configuration file where 

network connections are defined. You can modify this part of the 
file to define your system's network connections by changing the 
comm_inf o structure to reflect your configuration. See 
"Configuring Network Interfaces," page 119, for more 
information about this. (Your 

/usr/src/uts/cf . 5102 /conf . c configuration file can begin 
as a copy of the /usr/src/uts/cl/cf /conf . 5102 . c file.) 



/* 

^Network configuration section. 

*The network configuration section defines the external interfaces to 

*the system. Each channel is configured using the following format: 

* 

* { driver, ios, iop, channel, devtype, paths, dependent } 



driver - which driver type to use for this channel 

C OMM_HY_DR I VER - low speed driver 

COMM_SL_DRIVER - SUPERLINK driver 

COMM_HSX_DRIVER - HSX driver (includes HPPI) 
ios - IOS number 
iop - IOP number 

channel - channel number (octal) 

devtype - device type (see netdev.h for types) 

paths - number of logical paths 

dependent - driver dependent parameter 

C OMM_H Y_DR I VER - TCP interface information 

COMM_SL_DRIVER - not used at present 

COMM_HSX_DRIVER - definition flags 

(continued) 



SG-5201 7.0 



Cray Research, Inc. 



21 



Booting Preinstalled UNICOS [2] 



UNICOS Installation Guide for CRAYY-MPEL Computer Systems 



struct comm_info coiraninfo [ ] = { 



/* drv, ios, iop, chan, devtype, lpath, 

{ COMM_EN_DRIVER , 0, 0, 0x10, COMM_EN, 

{ COMM_EN_DRI VER , 0, 0, 0x11, COMM_EN, 

{COMM_EN_DRIVER, 0, 0, 0x12, COMM_EN, 



devword * / 



0, 0}, 
0, 0}, 
0, 0}, 



{ COMM_EN_DRI VER , 0, 0, 0x13, COMM_EN, 0, 0}, 
{ COMM_HY_DRI VER , 1, 0, 0x0, COMM_N400, 4, 0}, 
{ COMM_HY_DRI VER , 1,0, 0x1 , COMM_N4 00, 4 , 0 } , 
{ COMM_FDDI_DRIVER , 0, 0, 0x20, COMM_FDDI , 0, 0}, 
{COMM_FDDI_DRIVER, 0, 0, 0x21, COMM_FDDI, 0, 0}, 
{COMM_HSX_DRIVER, 4, 0, 000, COMM_HIPPI_SLB , 16, HXCF_HIPPI}, 
{COMM_HSX_DRIVER, 4, 0, 001, COMM_HIPPI_SLB, 16, HXCF_HIPPI}, 
{COMM_HSX_DRIVER, 4, 0, 016, COMM_HIPPI, 16, HXCF_HIPPI}, 

{COMM_HSX_DRIVER, 4, 0, 017, COMM_HIPPI, 16, HXCF_HIPPI}, 



int ncomm = (sizeof (comminfo) /sizeof (struct comm_info) ) ; 

int nhsx = 0 ; 

int nhy = 0 ; 

int nsf = 0; 

struct hx *hxdev; 

struct hy *hydev; 

struct sf *sfdev; 

#if ( CRAYEL ) 

struct fddi *fddidev; 

int nf ddi = 0 ; 

struct en *endev; 

int nen = 0 ; 

#endif /* CRAYEL */ 



>; 
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conf ig . mh configuration 

file 

2.6.2.3 



The / etc/ conf ig/ conf ig .mh configuration file shown in the 
following example must contain the system serial number and 
node name. Some selections are optional. 



/* USMID @(#) skl/etc/config/config.mh 70.13 05/13/92 08:52:54 */ 



/• 



/' 



* COPYRIGHT CRAY RESEARCH, INC. 

* UNPUBLISHED — ALL RIGHTS RESERVED UNDER 

* THE COPYRIGHT LAWS OF THE UNITED STATES. 

*/ 

* make/conf ig .mh - Configuration file for installation of UNICOS 



*/ 

/************************^ 

* * I 

/**************************************************** 

* * I 

/* 

* SECTION I 



Mandatory variables - Must be set on site for the Y-MP EL 



/* 

* The serial number of the system to generate 

*/ 

#ifndef CONFIG_SN 
#define CONFIG_SN 5102 
#endif 



/* 

* The name of the system. See uname(l) 

*/ 

#ifndef CONFIG_SYS 
#define CONFIG_SYS unicos 
#endif 



(continued) 
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/* 

* The node name of the system. The node name may be a name that the 

* system is known by to a communications network. See uname(l). 

*/ 

#ifndef CONFIG_NODE 
#define CONF IG_NODE unicos 
#endif 



/* 

* UNICOS Release Number 

* The following depict the major and minor numbers of this release. 

*/ 

#ifndef CONFIG_RLS_MAJOR 
# define CONFIG_RLS_MAJOR 7 
#endif 

#ifndef CONFIG_RLS_MINOR 
#define CONFIG_RLS_MINOR 0 
#endif 

#ifndef CONFIG_RLS_REVISION 
#define CONFIG_RLS_REVISION 4 
#endif 

/******************************************** 

* * J 

/***************************************************^ 

* * / 



* SECTION II 

* 

* 

* Optional variables - May be either on or off for the Y-MP EL 

*/ 



/* 

* The version name of the system. If unspecified, it defaults to the 

* value of the environment variable LOGNAME. See uname(l). 

*/ 

#ifndef CONFIG_VERSION 

#define CONFIG_VERSION $ LOGNAME 

#endif 

(continued) 
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/* 

* Name of the desired temporary-file directory to use. If the 

* TMPDIR environment variable is already defined, the following 

* default is NOT used. Reference tmpnam(3C) for more 

* information. 
*/ 

#ifndef CONFIG_TMPDIR 
#define CONFIG_TMPDIR /tmp 
#endif 

/* 

* Remote Process Control System (RPC) 

* CONFIG_TCP must be configured also if using this option. 
*/ 

#ifndef CONFIG_RPC 
#define CONFIG_RPC 1 
#endif 

/* 

* Network Remote File System (NFS) 

* CONFIG_TCP must be configured also if using this option. 

*/ 

#ifndef CONFIG_NFS 
#define CONFIG_NFS 1 
#endif 

/* 

* Kerberos 

* CONFIG_TCP must be configured also if using this option. 
*/ 

#ifndef CONFIG_KERBEROS 
# define CONFIG_KERBEROS 0 
#endif 

/* 

* Batch Management System (NQS) 
*/ 

#ifndef CONFIG_NQS 
#define CONFIG_NQS 1 
#endif 

(continued) 
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/* 

* Network testing tools 
*/ 

#ifndef CONFIG_NETTOOLS 
#define CONFIG_NETTOOLS 0 
#endif 

/* 

* Open Systems Interface 
*/ 

#ifndef CONFIG_OSI 
#define CONFIG_OSI 0 
#endif 

/* 

* File Transfer Agent (FTA) 

*/ 

#ifndef CONFIG_FTA 
#define CONFIG_FTA 0 
#endif 

/* 

* System Security 
*/ 

#ifndef CONFIG_SECURE 
# define CONFIG_SECURE 0 
#endif 

/* 

* If set to one (1) , the CONFIG_TAPE variable turns on the online tape 

* capability in the kernel. If set to zero (0), the code is turned 

* off. Its default is one (1), or ON. 

*/ 

#ifndef C ONF I G_TAP E 
#define CONFIG_TAPE 1 
#endif 

/* 

* Cray/REELlibrarian 
*/ 

#ifndef CONFIG_CRL 
#define CONFIG_CRL 0 
#endif 

(continued) 
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/* 

* Data Management /migration 

*/ 

#ifndef CONFIG_DM 
#define CONFIG_DM 0 
#endif 

/* 

* File quotas 
*/ 

#ifndef CONFIG_FQUOTAS 
#define CONF I G_F QUOTAS 1 
#endif 

/* 

* Runtime Control Ownership Restrictions Option 

* The following CONFIG_RC_OWNED is for restricting any . *rc file to be 

* owned by the user. For example, the . exrc file for vi . If this option 

* is set to on (1), vi will execute a .exrc file only if it is owned by the 

* user. This will prevent "trojan horses" being put into the .exrc file 

* by abusive users. If this option is off (0), the behavior of the vi and 

* the .exrc usage will be System V compatible. Note that other products 

* may implement this option at a later date. 
*/ 

#ifndef CONFIG_RC_OWNED 
#define CONFIG_RC_OWNED 0 
#endif 

^******************************* J 
/************************************************ 

/* 

* SECTION III 

* 

* 

* Static variables - Do not change these for the Y-MP EL 

*/ 

#ifndef CONFIG_ID 
#define CONFIG_ID UNICOS 

#ifndef CONFIG_ELS 
#define CONFIG_ELS 1 
#endif 

(continued) 
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/* 

* The target of the system to generate. If null, the existing 

* default is used. See target (1) for more information. 

*/ 

#ifndef C ONF I G_TARGET 
#define CONF I G_TARGET host 
#endif 



/* 

* Yellow Pages 
*/ 

#ifndef CONFIG_YP 
#define CONFIG_YP 1 
#endif 



/* 

* HSX device driver (uts kernel) 

* Also required by ultranet driver. 

*/ 

#ifndef CONFIG_HSX 
#define CONFIG_HSX 1 
#endif 



/* 

* The following definition contains the full path of the directory 

* which contains the generation software. 

*/ 

#ifndef CONFIG_GENBIN 

#if architecture ( cray) 

#define CONFIG_GENBIN /usr/gen/bin 

#else 

#define CONFIG_GENBIN /bin 

#endif 

#endif 



/* 

* The environment variable FPP is set to the value of 

* CONFIG_FPP. The cf77(l) command uses this variable. 

*/ 

#ifndef CONFIG_FPP 

#if architecture (cray) 

#define CONFIG_FPP CONFIG_GENBIN/ fpp 

#else 

#define CONFIG_FPP 
#endif 

# endi f (continued) 
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/* 

* The environment variable FMP is set to the value of 

* CONFIG_FMP. The cf77(l) command uses this variable. 
*/ 

ttifndef CONFIG_FMP 

#if architecture ( cray) 

#define CONFIG_FMP CONFIG_GENBIN/ fmp 

#else 

#define CONFIG_FMP 

#endif 

#endif 

/* 

* The environment variable CF77PP is set to the value of 

* CONFIG_GPP. The cf77(l) command uses this variable. 

*/ 

#ifndef CONFIG_GPP 

#if architecture (cray) 

#define CONFIG_GPP CONFIG_GENBIN/gpp 

#else 

#define CONFIG_GPP 

#endif 

#endif 

/* 

* The environment variable CFT77 is set to the value of 

* CONFIG_CFT77 . The cf77(l) command uses this variable. 

*/ 

#ifndef CONFIG_CFT77 
#if architecture (cray) 

#define CONFIG_CFT77 CONFIG_GENBIN/cf t77 
#else 

#define CONFIG_CFT77 

#endif 

#endif 

(continued) 
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/* 

* The environment variable GEN_SEGDIR is set to the value of 

* CONFIG_GEN_SEGDIR. The segldr(l) command uses this variable. 
*/ 

#ifndef CONF I G_GEN_S EGD I R 
#if architecture ( cray) 

#define CONF I G_GEN_S EGD I R CONFIG_GENBIN/ . . /lib/segdirs 
#else 

#define CONF IG_GEN_S EGDI R 

#endif 

#endif 



/* 

* Set C default to the generation cc compiler 
*/ 

ttifndef CONFIG_GCC 

#define CONFIG_GCC CONFIG_GENBIN/cc 
#endif 



/* Set nmake's CPP variable to the generation cpp */ 
#ifndef CONFIG_CPP 

#define CONFIG_CPP CONFIG_GENBIN/ . . /lib/cpp 
#endif 



/* 

* The following definition contains a list of products that must exist as 

* executables . This list is verified to exist when any part of UNICOS is 

* regenerated via nmake(l) . 

*/ 

#ifndef CONFIG_GENCMDS 

#define CONFIG_GENCMDS CONFIG_FPP CONFIG_FMP CONFIG_CFT77 CONFIG_GPP\ 
CONFIG_GCC CONFIG_CPP 

#endif 



/* 

* The following sets the generation software directory paths. The 

* environment variable PATH is set to the value of CONFIG_PATH. 
*/ 

#ifndef CONFIG_PATH 
#if architecture (cray) 

#define CONF IG_PATH CONFIG_GENBIN: /bin: /usr/bin: /usr/ucb 
#else 

#define CONF IG_PATH /bin: /usr/bin: /usr/ucb: /usr/local /bin 
#endif 

#endif (continued) 
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/* 

* The following sets the message catalog directory paths. 

* The environment variable NLSPATH is set to the value of 

* CONFIG_NLSPATH. 
*/ 

#ifndef C ONF I G_NL S PATH 
#if architecture ( cray) 

#define C ONF I G_NL S PATH /lib/nls/En/%N. cat 
#else 

# define CONFIG_NLSPATH 

#endif 

#endif 

/* 

* The following variable is intended to disable/enable the -o option 

* on a cpset. Most released software doesn't use the -o option thus 

* the following variable has no effect. 

*/ 

#ifndef CONFIG_CPSAVE 
#define CONFIG_CPSAVE 0 
#endif 

/* 

* TCP/IP Network System 
*/ 

ttifndef CONFIG_TCP 
#define CONFIG_TCP 1 
#endif 

/* 

* XI 1 Window Management System 

* CONFIG_TCP must be configured also if using this option. 
*/ 

#ifndef CONFIG_Xll 
#define C0NFIG_X11 1 
#endif 

(continued) 
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/* 

* Several Cray 1/XMP/YMP specific options. 
*/ 

/* 

* Cross targetted libraries (XLIBS) . 
* 

* In many cases, users require alternate libraries for binary 

compatibility. 
* 

* For example, on a Cray-YMP machine, you may need Cray-XMP compatible 

* (24 bit) libraries. On a Cray-Yl6 machine, you may need Cray-YMP 

* compatible (vector length = 64) libraries. 
* 

* These libraries are termed "cross targetted" (X) libraries. The 
definition 

* tags CONFIG_XLIBS and CONFIG_XLIBTARGET facilitates the activation of 
this 

* feature. You must set CONF IG_XL I BTARGET to reflect the architecture you 

* are targetting the libraries for. 
*/ 

/* 

* Build cross targetted libraries (XLIBS) 

* If you want the cross targetted libraries built and installed, 

* set the CONFIG_XLIBS variable to 1. 
*/ 

#ifndef CONFIG_XLIBS 
# define CONF IG_XL IBS 0 
#endif 

(continued) 
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/* 

* The following sets the TARGET for the desired set of cross targetted 

* libraries, i.e. cray-xmp, cray-x4 or cray-ymp. 
* 

* Note that these are not required on Cray-2 generations, 

* and can be set to null (e.g. #define CONFIG_XLIBTARGET) 

* in this case. 

*/ 

#ifndef CONFIG_XLIBTARGET 
#define CONFIG_XLIBTARGET cray-x4 
#endif 

#ifndef CONF IG_DECNET 
ttdefine CONFIG_DECNET 1 
#endif 

/* 

* Guest-mode /Native mode UNICOS kernel 

*/ 

#ifndef CONFIG_GOS 
#define CONFIG_GOS 0 
#endif 

/* 

* Expander chassis peripheral device drivers (uts kernel) 

*/ 

#ifndef CONFIG_EXPANDER 
#define CONFIG_EXPANDER 1 
#endif 

/* 

* Bit matrix multiply functional unit (uts kernel) 
*/ 

#ifndef CONFIG_BMM 
#define CONFIG_BMM 0 
#endif 

/* 

* IOS Model E support. 

*/ 

#ifndef CONFIG_IOS_E 
#define CONFIG_IOS_E 0 
#endif 

(continued) 
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/* 

* IOS serial numbers 
*/ 

#ifndef CONFIG_IOSA_SN 
# define CONFIG_IOSA_SN 0 
#endif 

#ifndef CONFIG_IOSB_SN 
# define CONFIG_IOSB_SN 0 
#endif 




/* 

* Number of IOS machines (0, 1, or 2). 

*/ 

#ifndef CONFIG_NIOS 
#define CONFIG_NIOS 1 
#endif 




/* 

* End of Cray 1/XMP/YMP specific options. 

*/ 




/* 

* Cray-2 specific options. 
*/ 




/* 

* If you want the Cray-2 flow libraries built and installed, 

* set CONFIG_FLOWLIBS to 1. 
* 




*/ 

#ifndef CONFIG_FLOWLIBS 
#define CONFIG_FLOWLIBS 0 
#endif 




/* 

* End Cray-2 specific options. 
*/ 


(continued) 
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/* 

* UNICOS Station Control Programs 
*/ 

#ifndef CONFIG_USCP 
#define CONFIG_USCP 0 
#endif 

/* 

* Network Monitor 
*/ 

#ifndef CONFIG_NETMON 
#define CONFIG_NETMON 0 
#endif 



/* 

* SuperLink 
*/ 

#ifndef CONFIG_SL 
# define CONFIG_SL 0 
#endif 

/* 

* If set to one (1), the C0NFIG_IPI3 variable turns on the ipi3 

* capability in the kernel. If set to zero (0), the code is turned 

* off. Its default is zero (0), or OFF. Note that IPI3 is supported 

* only on Model E machines. 

*/ 

#if CONFIG_IOS_E 
#ifndef C0NFIG_IPI3 
#define C0NFIG_IPI3 0 
#endif /* C0NFIG_IPI3 */ 
#endif /* C0NFIG_I0S_E */ 

/* 

* Ultra 
*/ 

#ifndef CONFIG_ULTRA 
# define CONFIG_ULTRA 0 
#endif 

(continued) 
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/* 

* Operator's workstation 
*/ 

#ifndef CONFIG_OWS 
#define CONFIG_OWS 0 
#endif 

/* 

* Enable repeatable relocatables 

* Clear timestamp in pdt. 
*/ 

ttifndef CONFIG_GENPROD_RULES 
#define CONF IG_GENPROD_RULES 1 
#endif 



/* 

* The online diagnostics require that the directory where the 

* online dignostics are kept be defined. The following variable 

* must be specified as a full path name to a directory where you 

* want the online diagnostics to be placed. 

*/ 

ttifndef CONF IG_DI AGDIR 
ttdefine CONF IG_DI AGDIR /ce 
#endif 

/* 

* Default umask(l) to be used during the build 
*/ 

#ifndef CONFIG_UMASK 
#define CONFIG_UMASK 022 
#endif 
#else 

$(:E=The file make/conf ig .mh has been included more than once) 
#endif 



conf ig . h configuration For certain configurations, the default UNICOS kernel parameter 

file settings may not be adequate. For example, configurations with 

2.6.2.4 more than one Ethernet controller may require a larger number 

of mbuf s defined in the kernel. See UNICOS System 
Administration, publication SG-2113, for more information about 
optimal kernel parameter settings for your system. 
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/* 

* SN5102 - config.h - Edition 0 [Wed Nov 25 11:13:32 CST 1992] 

* Created by Configuration Generator Rev. 70.65 
*/ 

/* USMID @(#)uts/cl/cf/config.h70.23 10/16/92 03:56:21 */ 
/* COPYRIGHT CRAY RESEARCH, INC. 

* UNPUBLISHED — ALL RIGHTS RESERVED UNDER 

* THE COPYRIGHT LAWS OF THE UNITED STATES. 
*/ 



#def ine 


NBUF_FCTR 


30 


/* 


default factor of cache to user memory */ 




# define 


NHBUF_FCTR 


2 


/* 


default factor of hash to cache */ 




#def ine 


NBLK_FCTR 


20 


/* 


factor for max blocks per request of cache 


*/ 


#def ine 


NPBUF 


n n n 

200 


/* 


number of physical (raw) buffer headers */ 




#def ine 


NASYN 


400 


/* 


number of async I/O headers */ 




#def ine 


MAXASYN 


35 


/* 


max number of outstanding async requests */ 




#def ine 


NSU_ASYN 


4 


/* 


number of asyn headers reserved for su */ 




#def ine 


MAXPIPE 


20 


/* 


Max # of blocks per pipe */ 




#def ine 


MAXRAH 


8 


/* 


Max read aheads */ 




#def ine 


NCRBUF 


4 


/* 


#of chkpnt ( ) and restart ( ) buffers */ 




# define 


NLDMAP 


250 


/* 


number of filesystems open concurrently */ 




# define 


NMNT 


250 


/* 


number of slice structures */ 




# define 


NMT 


16 


/* 


number of ddal tape devices */ 




#def ine 


NLDCH 


0 


/* 


Number of SSD logical device cache headers 


*/ 


#def ine 


LDCHCORE 


0 


/* 


Memory clicks reserved for ldcache blocks * 


/ 


#def ine 


NSIDEBUF 


1 


/* 
/* 


Number of blocks for side door, if in use * 
must be a multiple of disk i/o unit */ 


/ 


#def ine 


NPTY 


128 








#def ine 


NUSERS 


200 


/* 


max # of users (share) */ 




#def ine 


NPROC 


450 


/* 


Number of processes */ 




#def ine 


NSESS 


300 


/* 


#of session */ 




#def ine 


NCALL 


50 








#def ine 


NMOUNT 


75 








#def ine 


NFILE 


1500 








#def ine 


NINODE 


1000 








#def ine 


NC1INODE 


NINODE 


/* 


NINODE and NC1INODE must be equal */ 




#if 


F I LE_QUOTAS 










#def ine 


NQUOTA 


0 /* Default number of in-core quota entries */ 




#else 












#def ine 


NQUOTA 


0 








#endif 












#def ine 


NT EXT 


40 








#def ine 


NCLIST 


1000 








#def ine 


NFLOCKS 


100 


/* 


#of file lock regions */ 




#def ine 


ACNICE 


HZ 


/* 


Save lowest nice val . after n sees.*/ 




#def ine 


CDLIMIT 


(1L«231 


I /* 


max file size (2 A 23 blocks = 34*10 A 9 bytes) 


*/ 


#def ine 


MAX_UNLINKED_ 


BYTES 


26214400 




#if 

/* 


( (MODEL_E && 


BMX_CONF) 


II 


(MFSUBTYP == XMP6XX | | MFSUBTYP == YMPEL) ) 





* The amount of total system buffer space for tapes will be 

* TAPE_MAX_PER_DEV * TAPE_MAX_CONF_UP bytes. 
*/ 
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#define TAPE MAX PER DEV 



# define TAPE_MAX CONF UP 



65536 



16 



/* max number of bytes per device */ 

/* for buffered I/O */ 

/* This will be rounded up to the */ 

/* next 4K multiple */ 



/* max number of tapes that may be 
/* configured up */ 



7 



#endif 
/* 



* Data management (archive) parameters. 

* DMODE is a users default offline file retrieval mode. 

* DMODE = 0 selects manual only retrieval, 

* DMODE = 1 selects automatic as well as manual retrieval 
*/ 

ttdefine DMODE 1 
/* 

* The following defines are SLIPC related. 



/* default archived file retrieval mode */ 



*/ 

ttdefine SL IPCS 



#define SL KIPCMS 



#define SL WLISTS 



#ifdef CRAY2 
/* 



100 /* Maximum IPC devices must be greater than 

SLMAXSERV for Superlink to operate. 
Must be greater than 1 for the 
kernel to compile. */ 



4*SL IPCS 



/* Max kernel copies of IPC messages. 



One for each outstanding IPC I/O */ 
2*SL_IPCS /* max wait list entries used to skip 

IPC write messages queued and waiting 
for a matching read. */ 



* restrict the number of pblks Superlink uses 

* may be further reduced to NPBUF/2 

* at boot time. 
*/ 

#define SL_NPBUFS SL_IPCS 
#else 

#define SL_NPBUFS 2*SL_IPCS 
#endif 

ttdefine SL NBUFS 2*SL IPCS 



This 



#define SL MAXMSGS 



#define SL ABSMAXMSG 



/* Restrict the number of NBUF used by 
Superlink to this define. 
At boot time, this may further 
be reduced to NBUF/ 2 . */ 
25 ./* Maximum number of several informational 

messages that are printed by SLIPC 
and SLFS . There messages are printed 
when there is a resource shortage. 
If the messages get in the way, set 
this define to zero, of if memory 
is available, increase the resource. 
4*65536 /* the absolute maximum a process 

may set s_maxread */ 



/ 



* The following defines are SLFS related. 
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/* 

* SN5102 - config.h - Edition 0 [Wed Nov 25 11:13:32 CST 1992] 

* Created by Configuration Generator Rev. 70.65 
*/ 

/* USMID @(#)uts/cl/cf/config.h70.23 10/16/92 03:56:21 */ 
/* COPYRIGHT CRAY RESEARCH, INC. 

* UNPUBLISHED — ALL RIGHTS RESERVED UNDER 

* THE COPYRIGHT LAWS OF THE UNITED STATES . 

*/ 



#def ine 


NBUF_FCTR 


30 


/* 


default factor of cache to user memory */ 






#def ine 


NHBUF_FCTR 


2 


/* 


default factor of hash to cache */ 






#def ine 


NBLK_FCTR 


20 


/* 


factor for max blocks per request of cache 


*/ 


#def ine 


NPBUF 


200 


/* 


number of physical (raw) buffer headers * 


/ 




#def ine 


NASYN 


400 


/* 


number of async I/O headers */ 






#def ine 


MAXASYN 


35 


/* 


max number of outstanding async requests 


*/ 




#def ine 


NSU_ASYN 


4 


/* 


number of asyn headers reserved for su * 


/ 




#def ine 


MAXPIPE 


20 


/* 


Max # of blocks per pipe */ 






#def ine 


MAXRAH 


8 


/* 


Max read aheads */ 






#def ine 


NCRBUF 


4 


/* 


#of chkpnt ( ) and restart ( ) buffers */ 






#def ine 


NLDMAP 


250 


/* 


number of filesystems open concurrently * 


/ 




#def ine 


NMNT 


250 


/* 


number of slice structures */ 






#def ine 


NMT 


16 


/* 


number of ddal tape devices */ 






# define 


NLDCH 


0 


/* 


Number of SSD logical device cache headers 


*/ 


#def ine 


LDCHCORE 


0 


/* 


Memory clicks reserved for ldcache blocks 


* 


/ 


#def ine 


NSIDEBUF 


1 


/* 


Number of blocks for side door, if in use 


* 


/ 








/* 


must be a multiple of disk i/o unit */ 






#def ine 


NPTY 


128 










#def ine 


NUSERS 


200 


/* 


max # of users (share) */ 






#def ine 


NPROC 


450 


/* 


Number of processes */ 






#def ine 


NSESS 


300 


/* 


#of session */ 






#def ine 


NCALL 


50 










#def ine 


NMOUNT 


75 










#def ine 


NFILE 


1500 










#def ine 


NINODE 


1000 










#def ine 


NC1INODE 


NINODE 


/* 


NINODE and NC1INODE must be equal */ 






#if 


F I LE_QUOTAS 












#def ine 


NQUOTA 


0 /* Default number of in-core quota entries */ 






#else 














#def ine 


NQUOTA 


0 










#endif 














#def ine 


NTEXT 


40 










#def ine 


NCLIST 


1000 










#def ine 


NFLOCKS 


100 


/* 


#of file lock regions */ 






#def ine 


ACNICE 


HZ 


/* 


Save lowest nice val . after n sees.*/ 






#def ine 


CDLIMIT 


(1L«23; 


i /* 


max file size (2^23 blocks = 34*10 A 9 bytes) 


*/ 


#def ine 


MAX_UNLINKED_ 


BYTES 


26214400 






#if 


( (MODEL_E && 


BMX_CONF ) 


II 


(MFSUBTYP == XMP6XX 1 1 MFSUBTYP == YMPEL) 


) 





/* 

* The amount of total system buffer space for tapes will be 

* TAPE_MAX_PER_DEV * TAPE_MAX_CONF_UP bytes. 
*/ 
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#define MLS_INTEGRITY NORMAL /* OFF integrity code in secure. c */ 
/* 

* Parameters used for machine generated passwords 
*/ 

#define RANDOM_PASS_ON 0 

#define PASS_MINSIZE 7 
#define PASS_MAXSIZE 8 

/* 



/* 

/* 
/* 



1 = machine generated passwords enabled 
0 = disabled */ 
machine generated passwords minimum size 
machine generated passwords maximum size 



ok 



The following defines make NFS more useful while running 
a secure system at the price of a less secure system. 
Define NFS_SECURE_EXPORT_OK to be a non-zero value if it is 
to export a secure file system via NFS. 
The NFS code will then allow a remote system to access 
files at security level 0 with no ACLs and no compartments. 
Define NFS_REMOTE_RW_0K to be a non-zero value if it is ok 
to NFS-mount a remote file system in read-write mode. 
The NFS code will then allow users running at security level 0 
with no compartments to write files to the remote 
file system. 



*/ 

#define NFS_SECURE_EXPORT_ 
# de f ine NF S_REMOTE_RW_OK 
#define STAT RESTRICT NORMAL 



OK 



#define MAXLOGS 
# define LOGDELAY 
#define DELAY_MULT 
#define DISABLE TIME 



#define CONSOLE_MSG 

ttdefine DISABLE_ACCT 
#define MINSLEVEL 
#define MAXSLEVEL 
ttdefine SYSVCOMPS 



5 
0 
0 

600 



0 

1 

0 

16 



1 
1 

/* 
/* 
/* 
/* 
/* 
/* 



/* 
/* 
ON 



I 



non-zero if ok to export via NFS 
non-zero if ok to import via NFS 
restrict stat ( ) and secstat ( ) to 
active level or below */ 
max login attempts */ 
sees to delay between login tries 
multiplier for failed logins */ 
duration in seconds for which the user 
will be disabled when the MAXLOGS param 
is exceeded. If -1 (or any negative 
value) , disable indefinitely */ 
send a message to the console when */ 
MAXLOGS has been reached */ 
/* disable an account when MAXLOGS exceeded */ 
/* minimum security level */ 
/* maximum security level */ 
0777777777777777777777 /* valid system compartments */ 
#define SECURE_SYSTEM_CONSOLE "" /* secure console: administration */ 
#define SYSTEM_ADMIN_CONSOLE " /dev/console" /* default console: admin. */ 

#define SECURE_OPERATOR_CONSOLE "/dev/console" /* secure console: operator */ 



#define COMPART_ACTIVE_DEFAULT 0 

#define COMPART_VALID_DEFAULT 0 

#define DECLASSIFY_DISK 0 

#define OVERWRITE_COUNT 3 

#define DECLASSIFY_PATTERN 0 

# define SANITIZE_PATTERN 0 
/* 



/* generic defaults */ 



/* 
/* 
/* 
/* 



activate declsfy disk when not 0 * 
declassify disk overwrite count */ 
declassify disk write pattern */ 
scrub disk write pattern */ 



TCP/UDP/IP network related stuff 



I 
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* TCP_NMB SPACE 
* 

* This symbol controls the number of mbufs (TCP managed memory buffers) . 

* This pool of buffers is allocated at boot time in 

* usr/src/uts/tcp/kern/uipc_mbuf . c and cannot be increased while the 

* system is running. Factors which influence the number of mbufs 

* to allocate are: 
* 

* - Number of routing entries (each requires 1 mbuf) 

* - Number of active sockets (each requires 3 mbufs for the 

* life of the connection) . 

* - The above entries account for a small, but fixed pool of 

* mbufs. Additional entries are required to handle packet 

* headers, plus the data queued for input or output to active 

* connections. Allocating the maximum amount of data for these 

* connections is a waste, but deciding on a lower bound is 

* impossible. 

* - NFS. NFS consumes about 250 mbufs for static and dynamic 

* memory allocators. This is with one UIDMAP configured 

* for several machines. More mbufs (up to 100 more) will 

* be used with an average load, and more will be needed 

* for each uidmap as well . 

* 

* In the Mendota environment, our mbuf allocation is: 

* with NFS without NFS 

* Static routes (40 routes) 40 40 

* 65 users, fixed entries (3 ea) 195 195 

* 3 buffers each (avg) 195 195 

* NFS w/2 UID maps 300 

* Minimum allocation 730 430 

* We've set our number of mbufs 50% above the minimums to handle 

* transient peaks, file transfer and remote shell connections, and the 

* like. 
* 

* For a more complete treatment of how to set the TCP_NMBSPACE parameter, 

* review the section on mbufs in the administrator's guide. 
*/ 

#ifndef TCP_NMBSPACE 
#define TCP_NMBSPACE 1800 
#endif TCP_NMBSPACE 
/* 

* SECURE_NET_OPTIONS 
* 

* This symbol is used to select options for running tcp/ip on 

* a secure system. The global kernel variable secure_net_options 

* is initialized with this value. This variable is a bit mask 

* in which the following bits may be set: 
* 

* NETW_EXEMPT_NAL When this bit is set, hosts which do 
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* not appear in the NAL are allowed access 

* to the system at the unclassified level 

* (level = 0, compartments = 0) . When not 

* set, such hosts are denied access to the 

* system. 
*/ 

#define SECURE_NET_OPTIONS NETW_EXEMPT_NAL 

/* end of TCP/UDP/IP defines */ 



Customizing root After relinking the UNICOS kernel, you must customize the root 

(/) and /usr file ^ anc * ^ usr ^ e s y s t ems before changing the system to 

x * "** ^ multiuser mode. For further information about customizing the 

Systems roo t (/) an d / usr fQ e systems, see UNICOS System 

2-7 Administration, publication SG-2113. 



Changing to 
multiuser mode 

2.8 



After you have made the necessary changes to the UNICOS 
kernel parameter settings and to the root (/) and /usr file 
systems, enter the following to enter multiuser mode: 

# /etc/init 2 

The following messages are displayed on your screen: 



INIT: New run level: 2 

Day. Mon. X HH:MM:SS CST 1993 



If you correctly set the time on your IOS, the time reported here 
should be correct, because the UNICOS clock is set from the IOS 
clock (see "Setting the IOS clock," page 7). 

To change the date and time here, enter them in the format 
MMDDhhmmYYss and press |return| . You will receive several 
messages and a console login prompt. 

You are now in multiuser mode. The root password is initial, 
which you must change using the passwd command. For details 
about the passwd command, see the UNICOS User Commands 
Reference Manual, publication SR-2011. 
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Adding tape 
devices 

2.9 



If you plan to add additional tape devices to your CRAY Y-MP EL 
system, you should configure them at this time. To use the tape 
daemon software provided as part of the UNICOS standard 
release, see UNICOS System Administration, publication 
SG-2113. 

If you choose not to use the tape daemon software provided as 
part of the standard UNICOS release, you must configure 
additional tape devices that are added to your CRAY Y-MP EL 
system by using character special files. To configure additional 
tape devices by using character special files, see "Online Tape 
System," page 75. 



Boot procedures 
completed 

2.10 



The procedures for booting the preinstalled software are 
complete. You have booted the preinstalled IOS and UNICOS 
software, configured your disk space, customized the root (/) and 
/usr file systems, and are now ready to begin system 
operations. 



Installing Fortran 
and C compilers 

2.11 



If you plan to use the Cray Research Fortran or C compilers and 
they have not been preinstalled on your CRAY Y-MP EL system, 
you must order and install them as a separate product. To 
install the compilers, refer to the installation guide shipped with 
the compilers. 



Configuring MLS 

2.12 



If you want to configure multilevel security (MLS) on your 
system at this time, see "UNICOS Multilevel Security," page 99. 
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This section describes the procedures for sites that are currently 
running CRAY Y-MP EL system software and are upgrading to a 
new release level. The currently mounted root (/), /usr, and 
/usr/src file systems will be modified by this upgrade 
procedure. 



To begin, you must perform a full backup of your file systems by 
using the UNICOS dump utility because the upgrade procedure 
modifies the current mounted file systems. Also, if you do not 
have a current backup of your IOS disk, back that up now. See 
the UNICOS Administrator Commands Reference Manual, 
publication SR-2022, for information about the dump command. 
The following is an example of a root (/) file system dump to the 
quarter-inch cartridge (QIC) tape: 

# dump -t 0 -f /dev/rpqOl /dev/dsk/root 

To verify that the dumps completed successfully, use the 
restore -i command. This command lets you examine the 
contents of the tape without actually restoring anything. See 
the UNICOS Administrator Commands Reference Manual, 
publication SR-2022, for information about the restore 
command. 

If you have back-up root (bkroot) and back-up /usr (bkusr) file 
systems available, use them as online backups for your current 
system. You can use the following commands to perform these 
disk-to-disk backups: 

# /etc/dump -t 0 -f - /dev/dsk/root | /etc/restore -x -f - 

# /etc/dump -t 0 -f - /dev/dsk/usr | /etc/restore -x -f - 



Preparing to 
upgrade 

3.1 



SG-5201 7.0 



Cray Research, Inc. 



45 



Upgrade Installation [3] 



UNICOS Installation Guide for CRAY Y-MP EL Computer Systems 



The kernel configuration file conf . c must be saved to 
/usr/tmp. (This is the same file that was used to build the 
current running kernel.) Log in as root on your currently 
running system in multiuser mode and enter the following 
commands to save the conf . c kernel configuration file. In the 
following examples, replace SN with your system's serial 
number. 

# cp /usr/src/uts/cl/cf /conf .SN.c /usr/tmp /conf .c 



Note 

The els_upgrade script expects this kernel configuration file to 
exist in /usr/tmp and be named conf . c. 



Also place a copy of your current conf ig .mh file into /usr/tmp 
for reference purposes. You may want to refer to this later when 
setting up your UNICOS 7.0 conf ig . mh file. Use the following 
command line to do this: 

# cp /etc/conf ig/conf ig.mh /usr/tmp/conf ig.mh 

If your site is running NQS, you will need to follow these steps to 
prepare for the conversion of your NQS database: 

1. To avoid losing jobs, ensure that all NQS queues are empty 
(no queued or running jobs). Jobs left in the queues will be 
lost when upgrading to UNICOS 7.0. To empty the queues, 
first disable the pipe queues. When the pipe queues are 
empty, disable the batch queues. Wait until the batch queues 
are empty and no jobs are running before stopping NQS. 

2. Type qmgr to get the qmgr prompt (Qmgr 61.x:) 

3. Save the current NQS configuration. Saving your 
configuration with the following command will allow NQS to 
automatically rebuild your NQS configuration under UNICOS 
7.0. At the qmgr prompt, type the following: 

snap f ile=/etc/conf ig/nqs_conf ig 

4. Exit qmgr by typing exit at the qmgr prompt. 

5. Stop NQS with the qstop command (see qstop(8)). 



Saving your 6.1 
configuration files 

3.2 
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The disk space requirements for /usr/src on CRAYY-MP EL 
systems have been dramatically reduced for the UNICOS 7.0 
release. The recommended default value is 50,000 blocks. This 
is sufficient to hold all of the files necessary to relink UNICOS 
kernels and to build the CF77 and Cray Standard C (SCC) 
compilers. Table 3 shows the specific CRAYY-MP EL systems' 
requirements for UNICOS and various other products. 

Table 3. Disk space on /usr/src required for UNICOS and 
other products 



Product Size in 4 Kbyte blocks 

UNICOS 7.0 25,000 

CF77 5.0 11,500 

SCC 3.0 9,500 

Pascal 4.2 2,300 

Data migration 15,400 

DWB 9,100 

OSI 2.0 44,700 



Upgrading to a To upgrade to the UNICOS 7.0 release of the CRAYY-MP EL 

new release level system software, use the following procedures: 

3 3 1. Determine your site's disk space needs from Table 3 and then 

modify the existing conf ig . uni file to provide the required 
space. You will use this partition for the new 
/dev/dsk/src file system that is required for the 
CRAYY-MPEL system software 7.0 release (see "Configuring 
the peripherals," page 70, for information about modifying 
the conf ig. uni file). 

You can reclaim for your own use up to 100,000 disk blocks 
from the /dev/dsk/src file system when reconfiguring for 
UNICOS 7.0 because of the new, more efficient packaging 
scheme for 7.0. 
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The following examples depict parts of the conf ig . uni file 
before changes and after changes are made to allocate 50,000 
blocks for the /dev/dsk/src file system. Specific disk space 
requirements at your site dictate the number of blocks to 
allocate for this file system. 

Figure 2 shows the physical definition of an example 
conf ig . uni file before changes are made. In this example, 
tmp file system space is used to create the 50,000-block disk 
partition using a DD-3 disk drive. 



ESDI_010 := DD3 MIOP 1 


UNIT= 


0 ( 




0:usr_e010 /* 


50000 


blocks 


*/ 


150000 :tmp_e010 /* 


90000 


blocks 


*/ 


240000 :fs4_e010 /* 

) ; 


94200 


blocks 


*/ 



Figure 2. Physical definition of an example conf ig . uni file 
before modifications 



Figure 3 shows the physical definition of an example 
conf ig . uni file after changes are made. In this example, tmp 
file system space from two DD-3 disk drives is used to create a 
50,000-block partition for the src file system. 



ESDI_010 := DD3 MIOP 


1 UNIT=0 


( 




0 :usr_e010 


/* 50000 


blocks 


*/ 


150000:src_e010 


/* 50000 


blocks 


*/ 


200000 : tmp_e010 


/* 40000 


blocks 


*/ 


240000:fs4_e010 

) ; 


/* 94200 


blocks 


*/ 



Figure 3. Physical definition of an example conf ig . uni file 
after modifications 
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Figure 4 shows the logical definition of an example conf ig .uni 
file before changes are made. In this example, tmp file system 
space is changed and src file system space is added. 



tmp : 


= ( 


/* 990000 blocks */ 




tmp_e001 






tmp_e010 






tmp_e011 






tmp_e012 






tmp_e003 






tmp_e013 




) ; 







Figure 4. Logical definition of an example conf ig . uni file 
before modifications 

Figure 5 shows the logical definition of an example conf ig .uni 
file after changes are made, tmp file system space is changed 
and space is allocated for the src file system. 



src := ( /* 50000 blocks */ 

src_e010 

) ; 

tmp := ( /* 940000 blocks */ 

tmp_e001 
tmp_e010 
tmp_e011 
tmp_e012 
tmp_e003 
tmp_e013 

) ; 



Figure 5. Logical definition of an example conf ig . uni file 
after modifications 

Enter the following command lines to create the new 
conf ig. uni file: 

# cd / 

# exdf -i sy s/ conf ig. uni > conf ig. uni 

# vi conf ig. uni 

(add the 50,000-block partition for /dev/dsk/src) 
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2. After you have added the 50,000-block partition for 
/dev/dsk/src, verify the new conf ig . uni file by entering 
the following command line: 

# bconfig conf ig. uni 

3. Using the exdf command, write the new conf ig . uni file 
back to the IOS by entering the following: 

# exdf -o sys /conf ig. uni < conf ig. uni 

4. Switch your CRAY Y-MP EL system to single-user mode by 
entering the following command lines: 

# shutdown 0 (wait for shutdown to complete) 

# sync ; sync 

6. Insert the CRAY Y-MP EL system 7.0 release tape into QIC 
tape device. 



Caution 

Gently insert the tape into the Anaconda QIC tape device until it 
"clicks" into the load position and the drive takes the tape and 
completes loading it. 



7. Load the new IOS files from the QIC tape by entering the 
following command lines: 

# icoNTROL-al (toggles to the IOS console) 
IOS> cd / 

IOS> tar -xvf rpqOl 

The tar process takes about 10 minutes. 

8. After the new IOS files are loaded, reload the IOS and reboot 
your CRAY Y-MP EL system to single-user mode by entering 
the following command lines: 

IOS> reload 
IOS> boot 

9. Check the root (/) file system by entering the following: 

# fsck /dev/dsk/root 
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10. Create and check the new /dev/dsk/src partition by 
entering the following command lines: 

# mkfs -q /dev/dsk/src 

# fsck /dev/dsk/src 

# labelit /dev/dsk/src src 0 



Note 



If you used tmp space to create your src partition (page 48), you 
must now enter the following additional command: 



# mkfs -q /dev/dsk/tmp 



11. Mount the /usr file system by entering the following 
command lines: 

# fsck /dev/dsk/usr 

# mount /dev/dsk/usr /usr 



Note 

If your site is running UNICOS multilevel security (MLS), mount 
the file system(s) in the path for the disk resident security logs 
(/usr/adm/sl, by default). Then start the security log daemon, 
/etc/slogdaemon, by entering the following command line: 

# /etc/slogdemon 



12. Mount the /usr / src and tmp file systems by entering the 
following command lines: 

# mount /dev/dsk/src /usr/ src 

# fsck /dev/dsk/tmp 

# mount /dev/dsk/tmp /tmp 

The /usr /src file system should be empty at this point. If 
you have previously split your /usr file system into multiple 
file systems such as /usr/adm, /usr /spool, and so on, 
mount these file systems also at this time. 
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13. Transfer the five new upgrade utilities 

(/scripts/el s_upgr ade, /scripts/el s_upda t e, 
/scripts/unlabel . sh, /scripts /udbcvt . sh and 
/usr /gen/bin/ ldproto) and the new 

/etc/conf ig/conf ig.mh configuration file from the IOS to 
UNICOS by entering the following command lines: 

# cd / 

# exdf -i install/scripts. tar > /tmp/ scripts. tar 

# tar -xvf /tmp/ scripts. tar 

14. Using the file command, verify that you have the special 
devices necessary to read directly from the QIC tape device 
without using the tape daemon. The devices that must exist 
are /dev/rpqOl and /dev/nrpqOl. (The command, 
"file / dev / * rpq * ", should display the character special 
devices. The minor device numbers may be different from the 
following example, but must be unique.) If these devices do 
not exist, create them by entering the following: 

# mknod /dev/rpqOl c 43 008 64 01000 

# mknod /dev/nrpqOl c 43 108 64 01010 

15. If you are not using MLS, skip to step 16; otherwise, run the 
unlabel . sh script to unlabel the MLS commands, as shown 
following: 

# cd /scripts 

# . /unlabel . sh 

16. Edit the /etc/conf ig/conf ig.mh file as needed, using the 
following command, to set your system's serial number and to 
enable or disable features such as tapes or security. 
Comments in the file provide more information about this. 



Caution 

Change only the necessary items in section I and, if you want, 
the optional items in section II of /etc/conf ig/conf ig.mh. 
Do not change anything in section III of this file, or the 
resulting UNICOS kernel may not build or boot correctly. 



# vi /etc/conf ig/conf ig.mh 
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17. Invoke the els_upgrade script, with the following two 
commands: 

# cd /etc/ install 

# /scripts/els_upgrade 

This script takes about one hour to complete. Answer the 
three questions as they appear, or press ireturni to use the 
defaults shown in brackets [ ] . When you see the following 
message, the script is done: 



Successfully installed package. Upgrade process complete. 



The els_upgrade script completes the following functions: 

a. Positions the QIC tape device to the correct place on the 
installation tape, verifies the package type, and uses the 
ldproto command to load the UNICOS 7.0 package. 
Absolute binary files in the root (/) and /usr file systems 
are replaced and the /usr/src/uts directory is 
populated with the files needed to link a UNICOS kernel. 

b. Reads the conf . c file from /usr / tmp (placed there in the 
step on page 46) and creates the /usr/src/uts /cf .SN 
directory, where SN is your system's serial number. 

c. Runs the import and activate scripts from the UNICOS 
Installation and Configuration Menu System. 

d. Relinks a new kernel in /usr/src/uts/cf .SN. 

18. Make a back-up copy of your current kernel (SN is your 
system's serial number): 

# cd /usr/src/uts/cf .SN 

|C0NTR0L-a] (toggles to the IOS console) 

IOS> mv /sys/unlcos .ymp /sys/unicos .old 

19. Transfer the new kernel to the IOS disk by entering the 
following commands: 

icoNTROL-al [returnI (toggles to UNICOS console) 

# exdf -o sys/unicos .ymp < unicos 
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20. Unmount the file systems by entering the following: 

# cd / 

# /etc/umountem 

# /etc /shutdown 0 

# sync; sync; sync 

|coNTROL-a| (toggles to the IOS console) 

21. Use the following commands to remove the MEMORY = 
statement from the conf ig . uni file before booting the 
UNICOS 7.0 kernel: 

IOS> cd / 

IOS> ed sys /conf ig. uni 



Caution 

Failing to remove the MEMORY statement (required in earlier 
releases) from the conf ig . uni file may cause a pscan error 
when booting. 



22. Now boot the UNICOS 7.0 kernel, as follows: 

IOS> boot (boots your UNICOS kernel to single-user mode) 

23. If you are not using MLS, skip to step 24; otherwise, enter the 
following commands to label your trusted binaries and files: 

# /etc/tsubcmd -i -1 

# /etc/udbcmd -i -1 

The -1 (label only) option properly labels security-sensitive 
files without removing them from their target locations. 

See "Upgrading your MLS system to 7.0," page 111, for 
further information on MLS configurations. 
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24. Convert your udb to UNICOS 7.0 format, then start up 
multiuser mode by entering the following: 

# fsck /dev/dsk/root 

# mount /dev/dsk/usr /usr 

# / script s /udbcvt . sh 



Converting udb to new format 



Multi Level Security (Y/N) [N] : 

UDB conversion. 
215 entries converted to source 
Input style: udb 
added 215 records 
Header tables updates 3 times 

UDB conversion complete. 



Due to changes to the internal NQS structures between UNICOS 
6.1 and UNICOS 7.0, the /usr /spool /nqs database from 
previous CRAY Y-MP EL UNICOS releases cannot be used with 
UNICOS 7.0 NQS. Consequently, no NQS jobs will be preserved 
across the upgrade to 7.0. 

To convert your NQS database to UNICOS 7.0, enter the following 
command: 

# / script s/nqscvt .sh 

For more information on NQS differences, refer to the 
"Compatibilities and Differences" section of the UNICOS 7.0 
Release Overview for CRAY Y-MP EL Systems, publication 
RO-5200. 



Network 
Queueing System 
(NQS) 

3.3.1 



Network file system The binary format of NFS UID maps has changed between 

(NFS) UID maps UNICOS release 6.1 and 7.0. To create a 7.0 UID map, you must 

3.3.2 recreate the UID maps by using the 7.0 utilities. This is 

typically done by a script called 

/etc /uidmaps /Merge . domains. You can create this script for 
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your site using the file / etc /uidmaps /Merge . exmple as a 
template. The standard UNICOS script, /etc/nf sstart, will 
call the Merge . domains script if the marker file 
/etc /uidmaps / .merge exists. 



Upgrade Th e upgrade procedures are now complete. Your CRAY Y-MP EL 

nr«f»f*diiT'**«! system is ready to begin system operations. To boot the system 

^ , , to multiuser mode, type the following commands: 

completed 

3.4 # cd / 

# /etc/umountem 

# init 2 



56 



Cray Research, Inc. 



SG-5201 7.0 



Reinstalling UNICOS [4] 



If you are doing an initial installation (not using preinstalled 
software), follow the procedures described in this section. Initial 
installations are performed at the factory prior to shipping. 



Caution 

The procedures in this section are for an initial installation and 
may destroy any preinstalled CRAY Y-MP EL system software. 



Tape and tape Your CRAY Y-MP EL system software tape set consists of three 

device quarter-inch cartridge (QIC) tapes. 

41 • One CRAY Y-MP EL system software tape that contains both 

the UNICOS and IOS software. This tape is labeled "ELS 
UNICOS 7.0 RELEASE EL-7.0 UNICOS FOR Y-MP EL ONLY." 

• One IOS back-up tape that contains configuration files, flaw 
files, and a relinked kernel. 

• One scan file tape. 

Figure 6 illustrates the Anaconda QIC tape device found on your 
CRAY Y-MP EL system. 
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Activity Eject 
LED button 



Tape loading 
aperture 




Figure 6. Anaconda QIC tape device 



The QIC device is recognized as rstO when the system is 
operating from programmable read-only memory (PROM) and 
either rstO or rpqOl when operating from the IOS. On UNICOS, 
the QIC device is recognized as rpqOl. 



Note 

When a new tape is loaded into the tape drive, you must allow 
about 30 seconds for the drive to ready the tape. Understanding 
that there is a delay is important when trying to access the tape 
through a UNIX character special file interface (either from the 
IOS or from UNICOS) rather than through the UNICOS tape 
daemon. 



When your system is powered up, you will see the BOOT> prompt 
on your system console. Before you can install the IOS software, 
you must create an IOS file system on the SCSI hard disk, as 
described in subsection 4.2. After the file system is created, 
transfer the IOS files from the QIC tape device to the IOS (SCSI) 
disk device by using the tar command, as described in 
subsection 4.3. 



58 



Cray Research, Iric. 



SG^5201 7.0 



UNICOS Installation Guide for CRAYY-MPEL Computer Systems 



Reinstalling UNICOS [4] 



Create the IOS file 
system 



4.2 



The following subsections describe the procedures for creating 
and installing the IOS file system. To create the IOS file system 
on the SCSI disk, enter the following: 



Warning 

The mkf s command destroys all files previously written to the 
IOS disk. 



BOOT> mkfs c: 

This process takes about 7 minutes to complete. If the IOS file 
system has not been created yet, the system responds by 
displaying output similar to the following on your console screen: 

Cluster size 4096 bytes 

Max. Contiguous Free - 48373 



In Use 

Free 

Bad 

Reserved 
Erroneous 

Total 



0 

48373 
0 
0 
0 

48373 



The following message indicates that the file system has already 
been created and mounted on your CRAY Y-MP EL system: 



disk buffer 'cachel:' mounted 
'wdla: ' already mounted 



If you encounter this message on your CRAY Y-MP EL system, 
you must unmount the existing file system by entering the 
following command: 

BOOT> umount c: 

After the unmount operation is complete, create the new IOS file 
system by entering the following: 



BOOT> mkfs c: 
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Install the IOS CRAY Y-MP EL systems can support up to 16 I/O subsystems. On 

software CRAY Y-MP EL systems that have more than one IOS, the master 

4 3 IOS has interfaces to the system console and its own Small 

Computer System Interconnect (SCSI) bus with a Winchester 
hard disk, a quarter-inch cartridge (QIC) device, and an optional 
8-mm EXABYTE tape device. 

To install the IOS files, insert the QIC tape labeled "ELS UNICOS 
7.0 RELEASE EI^7.0 UNICOS FOR Y-MP EL ONLY" into your QIC 
tape device. 



Caution 

Gently insert the tape into the QIC tape device until it "clicks" 
into the load position. The Anaconda QIC tape device senses the 
tape and automatically completes the load operation. 



After the tape is inserted, load the IOS files by entering the 
following: 

BOOT> tar -xvf rstO 

If the command fails and a blocksize = 0 message is 
displayed, issue the tar command a second time to read the 
tape. This is a known problem with the QIC driver in PROM, 
which will be fixed in a future PROM revision. 

The BOOT> prompt returns after about 10 minutes. During the 
loading of the IOS files, you will see output similar to the 
following on the your console screen: 



BOOT> tar -xvf rstO 

x ./ios/ios 100 tape blocks 

x . /ios/ios .nm 8 tape blocks 
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Install the scan At this point, you should install your scan files from the QIC 

f-Q es tape that contains these files. The tape contains instructions for 

4 loading these files onto your IOS SCSI disk. If you do not have 

current scan files on tape, contact your CRI customer service 
representative and install them before continuing. 



Copy site- After you load the IOS files, you must copy one file and one script 

deDendent IOS from the /install directory to their proper destinations. This 

4.;! step ensures that subsequent installations of IOS software 

* 1 ^ es releases do not overwrite the critical IOS and UNICOS files. 

4.5 

At the BOOT> prompt, enter the following command lines to copy 
the generic UNICOS kernel and boot script to their proper locations 
on the IOS disk: 

BOOT> cp / install /unicos .ymp /sys/unicos .ymp 
BOOT> cp /install /boot .ymp /bin/boot 



IOS /conf ig file The procedures in this subsection automatically generate the 

4.5.1 /config file on the IOS. This file contains information about 

the mainframe architecture, the number of CPUs, and the 
strategies and driver software types loaded into the IOS during 
the initial system boot. 

The following example / config file reflects a sample IOS in 
which the master IOS is configured with ESDI disk controllers, a 
standard SCSI bus, and console. The slave IOS is configured 
with an Ethernet connection and IPI disk controllers. If your 
site ever alters its hardware configuration (adds or removes 
CPUs, IOSs, controllers, peripherals, etc.), you must modify this 
file to reflect those changes. 
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# 

# Define architecture: 
# 

ARCH=YMP-EL 
# 

# Define the slots (0, 1, 2, and 3) in the system cabinet that have CPUs. 

# This CRAY Y-MP EL configuration has one CPU in slot 0. 

NCPUS=0 
# 

# If this configuration had a multiple CPU system with CPUs in slots 0 and 2, the entry 

# would be NCPUS=02. 
# 

# The master IOS is always IOSO. The 1274 value is the serial number from this 

# sample IOP board. The serial number is stored in nonvolatile random-access memory 

# (NVRAM) and is unique for every Heurikon board. Figure 7, page 64, shows IOS 

# Heurikon boards. Refer to this illustration for the serial number location on IOS 

# Heurikon boards. 
# 

# In a single IOS system, the IOSO : SN statement is optional unless the MME software 

# is running on the Cray Research maintenance workstation (MWS). It is good practice 

# to include this statement. 
# 

IOSO: 1274 1228800 
# 

# The following are strategy names, which are modules that manage packets, 

# communicate with UNICOS, and handle memory management with the I/O buffer 

# board (IOBB). Only the first (master) IOS has the /dev/ 'console strategy; the 

# master IOS also requires /dev/ tape. 
# 

# Strategy name 

# 

/dev /disk 
/dev/ tape 
/dev/console 

(continued) 
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# The possible device strategies are as follows: 
# 

# /dev/consol e (master IOS only) 

# /dev/di sk ( disks) 

# /dev/ethnet (Ethernet) 

# /dev/hynet (HYPERchannel - strategy and driver) 

# /dev/f dnet (FDDI network) 

# /dev/ tape (tapes - nontape daemon) 

# /dev/ taped (tapes - tape daemon) 
# 

# The following are device drivers. The device drivers you use in your configuration 

# must be listed and loaded after the strategy names: they are device specific. The 

# master IOS also requires /dev/ s tape. 

# Device driver name 

# 

/dev/stape 
/dev/esdi 

# The possible device drivers are as follows: 
# 

# /dev/s3560 (SCSI controller driver - if included, this driver must precede 

# /dev/stape) 

# /dev/s tape (EXABYTE and QIC tapes) 

# /dev/esdi (ESDI disk driver) 

# /dev/ das (disk array) 

# /dev/ ether (Ethernet driver) 

# /dev/ipi (IPI-2 disk driver) 

# /dev/bm (buffer memory resident) 

# /dev /per tec (STK or PERTEC 9-track tape) 

# /dev/fddi (Fiber Distributed Data Interface driver) 
# 

IOS1: 1632 1228800 
# 

# Strategy names: 

# 

/dev/disk 
/dev/ethnet 

# 

# Device drive names: 

# 

/dev/ipi 
/dev/ ether 
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Figure 7 shows an IOS Heurikon board that is found inside the 
right-side panel of your CRAY Y-MP EL system. 




Figure 7. IOS Heurikon boards 



IOS I sys /unicos . ymp The IOS / sys /unicos . ymp file is a generic, bootable UNICOS 

file kernel file. This kernel file is used when initially booting your 

4.5.2 system. Later, as part of the installation process, you will create 

a new custom kernel and write it to the /sys / unicos. ymp file. 



64 



Cray Research, Inc. 



SG-5201 7.0 



UNICOS Installation Guide for CRAY Y-MP EL Computer Systems 



Reinstalling UNICOS [4] 



IOS /bin/boot script The /bin/boot start script boots the UNICOS system and 

4.5.3 contains the IOS commands that are used to load the UNICOS 

kernel and to begin communication between the IOS and 

UNICOS. 



Automatic initial 

installation 

procedure 



4.6 



A new, automated initial installation procedure has been 
developed for the UNICOS 7.0 release for CRAY Y-MP EL systems. 
This procedure automates most of the initial install process. 
Three IOS-resident utilities (in the /install directory) are used 
in this process that perform various functions as described 
below: 

Utilities Description 

ldios This utility prompts the installer for the 

system architecture, number of CPUs, memory 
size, number of IOSs and their Heurikon serial 
numbers, and whether the tape daemon should 
be run. It then generates the /conf ig file on 
the IOS without any strategies or drivers 
defined. 



drivers This utility probes all IOSs to determine the 
number and types of controllers that exist. It 
then updates the IOS /conf ig file 
appropriately and executes a reload command 
to the IOS to activate strategies and drivers for 
all system controllers. 

ldunicos This utility optionally creates a default 

/sys/conf ig.uni file, which UNICOS uses to 
allocate disk space to file systems. It then 
boots UNICOS, using only a DDRAM resident 
iroot file system (that is, no disk space 
required) and loads the default root (/), /usr, 
and /usr/src file systems from the release 
tape. 
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To perform an initial installation on a CRAY Y-MP EL system, 
follow the steps below: 

1. At the BOOT> prompt, enter /install/ldios. Answer all of 
the questions. You will see output similar to the following: 



BOOT> /install/ldios 

System architecture [YMP-EL] : 

Number of mainframe cpus[l] : 3 

Memory size (mw) of mainframe [32 ] : 64 

Enter number of ios(s) [1] : 2 

Enter the serial number for IOSO : 1870 

Enter the serial number for IOS1 : 1990 

Configure the tapedaemon [n] : y 



2. When you have answered all the preceding questions, issue a 
load command at the BOOT> prompt: 



BOOT> load 
output from load 
IOS> 

3. At the IOS> prompt, enter /install /drivers: 

IOS> /install /drivers 

output from drivers 
IOS> 
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4. At the IOS> prompt, type /install/ldunicos and answer 
the questions, as follows: 

• First question: If you want to automatically configure the 
disks, answer Y. This creates a /sys /conf ig . uni file 
automatically. If you already have created a customized 

/ sys / conf ig. uni file, answer N. 

• Second question: To automatically load the root (/), /usr, 
and /usr/src file systems from the release tape, answer Y. 

After you answer the questions, a DDRAM-resident iroot file 
system will be used to boot UNICOS, and the load of the 
UNICOS file systems will commence. 

This procedure assumes that the root (/), /usr, and 
/usr/src file systems will reside on the logical file systems 
/dev/dsk/root, /dev/dsk/usr, and /dev/dsk/src , 
respectively. 



If you answer N to both questions, you may run the 
els_install utility in single-user mode to chose the different 
logical names for the file systems. 



This step takes approximately 90 minutes. 



Note 




IOS> /install/ldunicos 



Do you want to 



auto configure the disks [Y] : 



Autogen Normal 



Termination 



Do you want to 



auto install the software[Yj: 



more output from 



ldunicos 



Installing of system software has successfully completed. 



# 
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With your bootable UNICOS utilities installed, you must the ed 
command to edit the /bin/boot script on the IOS. It must be 
edited to match the number of CPUs and memory size on your 
CRAY Y-MP EL system before booting UNICOS. 

# |coNTROL-al (toggles to the IOS console) 
IOS> ed /bin/boot 

A sample boot script file follows: 



mc 
mc 
# 

# Uncomment the following js tar command for each additional CPU present 

# on your CRAY Y-MP EL system. For example, if you have a system with two CPUs, 

# uncomment the entry ds /sys/jstar 1. 
# 

# ds /sys/jstar 3 

# ds /sys/jstar 2 

# ds /sys/jstar 1 
# 

echo Zeroing memory. Please wait... 
# 

# Uncomment the zero memory command that matches your machine's memory size. 
# 

# ds /sys/zerol28 0 

# ds /sys/zero64 0 

# ds / sys / zero32 0 
# 

wait 5 

echo Clear memory complete. Loading UNICOS... 

lu /sys/unicos .ymp /sys/conf ig .uni 

echo Starting unicos 

iostart 

ds 

conswitch 



Edit the boot 
script 

4.7 



Set the IOS clock To verify that the IOS clock is set for your local date and time 

4 8 and to adjust this clock, use the time command: 

IOS> time 
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The time reported and set by this command is the time that 
UNICOS will boot with; therefore, be sure it is correct, so you do 
not have to change it later for UNICOS and then have your 
UNICOS clock be out of sync with your IOS clock. 

For more information on the time command, see the 
CRAY Y-MP EL System-specific Administrator Commands 
Reference Manual, publication SR-2408. 



Use the rcmd command to execute IOS commands on slave IOSs 
(slave IOSs are those controlled by the IOS designated as the 
master IOS. The master IOS can perform actions that the slaves 
cannot). For information about the rcmd command, see the 
CRAY Y-MP EL System-specific Administrator Commands 
Reference Manual, publication SR-2408. 



IOS> icoNTROL-al |return| (toggle s to the UNICOS console) 

# shutdown 0 

# sync; sync; sync 

IcoNTROL-al (toggles to the IOS console) 
IOS> boot 

To complete the booting of your UNICOS system, go to "Modify 
the parameter file conf ig . uni," page 18, and follow the steps 
there to the end of section 2. 



Note 



Reboot the 
UNICOS system 



Now use the following command lines to shut down UNICOS and 
reboot the system from disk: 
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A generic /sys/conf ig.uni file (on the IOS disk) was 
generated automatically by the automated initial installation 
process described in "Automatic initial installation procedure," 
page 65. 

This subsection describes how to reconfigure your peripherals by 
editing the automatically generated /sys/conf ig.uni file and 
changing the configuration specification language (CSL) 
variables. 

Using CSL, you will define run-time system configurable 
variables, your disk peripherals, and file systems. See UNICOS 
System Administration, publication SG-2113, for more 
information about CSL. 

To familiarize you with CSL, an overview is provided. The 
overview includes a description of CSL, provides parameter 
setting recommendations, and a sample configuration file. 

The first step involves the use of the UNICOS CSL to define 
run-time system configurable variables, your disk peripherals, 
and file systems. The second step, used to customize your 
UNICOS kernel, is presented in "Relink the UNICOS kernel," 
page 19. You must complete both steps as part of the 
installation of the UNICOS software. 



Configure the 
peripherals 

4.11 



Note 

System performance is significantly impacted by disk 
configuration. See UNICOS System Administration, publication 
SG-2113, for details about file system placement. 



Configuration CSL is used to describe configuration and run-time parameter 

specification language settings that are interpreted when you boot UNICOS. CSL 

(CSL) overview statements permit you to extend or override the default 

4. 11. 1 configuration by letting you do the following: 

• Define the physical attributes of your disk devices 

• Define the logical grouping of your physical disk slices 

• Define system devices 

• Configure logical device cache 
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• Define memory size (required) 

• Define the number of IOSs, CPUs, and channels 

Your /sys/conf ig.uni file contains the definitions of your 
physical, logical, and system disk devices. Optionally, 
/sys/conf ig.uni can contain CSL statements to modify or 
override specific UNICOS kernel parameters and the additional 
statements required to configure UNICOS disk striping. 

Each time the UNICOS operating system is booted, UNICOS 
interprets and sequentially processes the CSL statements; 
therefore, the order of your CSL statements is very important. 
After processing the CSL file, UNICOS automatically creates the 
following parameter files that reflect the current system 
configuration. These files are written to the following UNICOS 
file names: 

File name Definition 

/ IOS-param This file is an exact copy of your CSL 

file. 

/CONFIGURATION This file contains CSL-defined 

definitions and compiled UNICOS 
kernel definitions. 

/unicos This file is a copy of the running 

UNICOS kernel. 



CSL recommendations When configuring UNICOS during the installation process, you 

4.11.2 must use CSL to define the size and location of the disk region 

used for the root (/), /usr, and /usr/src file systems. You 
must also use CSL to define the size and location of the UNICOS 
swap and dump devices, /bkroot (back-up root), /bkusr 
(back-up /usr), /tmp, and /core. The remaining space is 
typically allocated as /home or site-defined file systems. The 
recommended size of the dump device is 65,536 blocks. 
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Note 

Disk and buffer memory resident (BMR) partitions are defined in 
units of blocks (1 block = 4096 bytes) on CRAY Y-MP EL systems. 



Balancing I/O To balance your I/O, place the root (/) and /usr file systems on 

4.11.2.1 different disk drives. If possible, also isolate the root (/) and 

/usr file systems on different disk controllers. The 
recommended disk drive for the root (/) and /usr file systems is 
the DD-4 disk drive; use the DD-3 and DDESDI disk types as 
alternatives. 



Defining the root (/), The root (/), /usr, and /usr/src file systems that you define 

/usr, and /usr/src file in this step will become the location of your root (/), /usr, and 

systems /usr/src file systems when you run els_install. You must 

4.11.2.2 define the root (/) and back-up root (/bkroot) file systems as the 

same size; they require a minimum of 90,000 blocks. You must 
also define the /usr and back-up /usr (/bkusr) file systems as 
the same size; they require a minimum of 150,000 blocks. The 
/usr/src file system requires a minimum of 50,000 blocks. 



Configure the swap device Generally, you should configure your swap device to be three to 
4.11.2.3 eight times larger than your UNICOS main memory. If your 

system includes a disk array subsystem (DAS), use it for your 
swap device. By using the DAS for your swap device, your 
CRAY Y-MP EL system performance will be optimized because the 
DAS is best suited for large-block sequential I/O. The DAS is also 
an excellent location for seldom-used file systems or application 
disk space. 

If you have no DAS, configure your swap device on available 
DD-4 or DD-3 disk drives. Locate your swap device on different 
disk drives than those used for your user's /home directories and 
applications. 



Configure the stripe groups Stripe group members must be placed on the same disk type (for 
4.11.2.4 example, DD-4), be the same length, and start at the same block. 

When possible, place stripe group members on separate 

controllers. 
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A striped swap configuration example of stripe_20 and 
stripe_30 on IPI disk drives follows: 



STRIPED := DDSTR ( 

stripe_20 + stripe_30 /* 150000 blocks */ 

) ; 

swap := ( /* 150000 blocks */ 

stripe_2 0 

) ; 



Using a buffer memory When using a BMR device, you should adhere to the following 

resident (BMR) device rules: 

4.11.2.5 

• Striped file systems cannot contain BMR partitions. 

• Banded file systems (physically adjacent file systems on a 
disk) may be composed of BMR partitions from more than one 
IOS. 

• BMR and disk partitions can be mixed in file systems that are 
not striped. 

• The swap device can be defined to include partitions of BMR 
from more than one IOS. 

• A BMR device defined as ldcache can be used only to cache 
file systems that are wholly composed of disk partitions that 
reside within the same IOS as that BMR device. 

• The CSL BMRDEV statement cannot be defined to include 
partitions of a BMR device from more than one IOS. 
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Disk types Table 4 shows the disk types that can be configured on your 

4.11.3 CRAY Y-MP EL system: 

Table 4. CRAY Y-MP EL system disk types 



Disk type 


Description 


Number of 

ncifiT nlr»r»lrc! 

per device 


tjcttui 0/ 

track 


JJJJJlioJJl 


wiq jiioiJi anve 


1 /U,1UU 


Q 

a 


DD-3 


New ESDI drive 


334,200 


10 


DR-1 


Removable ESDI 


334,200 


10 


DD-4 


IPI-Sabre 7 


653,000 


28 


DDLDAS 


Old DAS 


1,269,114 


65 


DDAS2 


New DAS 


2,502,000 


75 


DDBMR 


VME RAM device 


Multiple of 
32,768 




DDRAM 


Central memory 
resident 


Configuration 
dependent 





Sample CSL settings The sample /sys /conf ig . uni file on page 13 contains CSL for 

4.11.4 a CRAY Y-MP EL system with two CPUs and two IOSs. This file 

exemplifies a configuration for the basic file systems and ten 
sample file systems (fsl...fsl0). Each file system name has a 
suffix of the form jdxyz, where the letters have the following 
meanings: 

Component Meaning 
d Device type 

x IOS number 

y Controller number 

z Unit number 
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CRAY Y-MP EL systems are designed with a tape subsystem that 
provides you with two methods of accessing the tape devices. 
One method uses the feature-rich tape daemon software 
provided as part of a standard UNICOS software release. This 
method offers features such as multivolume support, labeled 
tapes, tape silo access, and data buffering. The tape daemon 
also offers users a lot of tape device control, flexibility, and 
security. 

Use of the standard UNICOS tape daemon requires you to specify 
a tape daemon configuration file. All user tape device requests 
are made through the tape daemon, which actually manages the 
devices. See UNICOS System Administration, publication 
SG-2113, for information about configuring tape devices under 
tape daemon control. 

The second method is similar to the traditional UNIX approach of 
accessing tape devices by using character special files. The 
character special file tape interface permits standard UNIX 
control over tape devices. To create these character special files, 
use the standard mknod UNICOS utility. Information about how 
to create character-specific files is provided in this appendix. 



Note 

Multivolume support is not provided with the character special 
file tape interface. 



For information about cleaning and maintaining your tape 
subsystem, see the CRAY Y-MP EL Basic Administration Guide, 
publication SG-2416. 
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Configuring your Your CRAY Y-MP EL system is initially supplied with sufficient 
Online tape SVStem specif files for most basic device configuration. You must 

^ configure additional tape devices that will not be controlled by 

the tape daemon by creating additional character special files. 
These additional character special files establish a connection 
between an arbitrary path name and the actual specified device. 
Each special file resides under the UNICOS /dev directory. The 
following subsections describe the components of special files 
that support additional devices on your CRAY Y-MP EL system. 



Components of 
character special 
files 

A.2 



Each character special file consists of a special file name and 
mknod information. The following command line creates a new 
character special file under the /dev directory. The special file 
name is defined first, followed by the mknod information: 

mknod /dev/rpq010 c 43 008 64 01001 



Special file name 



mknod information 



Figure 8 shows the components of special file names and mknod 
information. 
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mknod /dev/rpq010 c 43 008 64 01001 



Special 

file 

name 



mknod 
information 



controller type 
device type — 
controller # — 
device # 



logical unit # — 
special file type 

major # 

minor # 

IOS# 



controller type 
device type — 
controller # — 
device # 



logical unit # 
rewind status 
density 



Figure 8. Special file name and mknod components 
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Tape special file 
naming convention 

A.2.1 



The special file name variables are as follows: 
Variable Description 

controller type Governs the functions of the attached 
devices. Possible values are as follows: 



device type 



controller # 



device # 



logical unit # 



Type 



P 
s 

m 



Description 
I/O processor 

Small Computer Systems Interface 
(SCSI) controller 

PERTEC controller 



Defines device being used. Possible values 
are as follows: 



Type 



Description 

Quarter-inch cartridge (QIC) tape 
device 

EXABYTE tape device 
STK square tape 
9-track tape (PERTEC) 



Defines controller being used. Possible values 
are as follows: 

Type Description 
0 I/O processor 

0-7 SCSI and PERTEC 

Defines device ID number. Possible values are 
as follows: 

Type Description 



0- 6 

1- 6 
0-3 



SCSI 

I/O processor 
PERTEC 



Defines the SCSI logical unit being used; 
optional value. This field does not apply to 
PERTEC tapes. Possible values are as follows: 



Type 
0-7 



Description 
SCSI 



78 



Cray Research, Inc. 



SG-5201 7.0 



UNICOS Installation Guide for CRAYY-MPEL Computer Systems 



Online Tape System [A] 



Tape special file mknod 
fields 

A.2.2 



The variables of the special file mknod fields are as follows: 
Variable Description 

special file type Specifies the special file type entry. 

Type Description 

c Creates character special file. 

Specifies major device number. 

Type Description 
4 3 Major number is always 4 3 . 



major # 
minor # 

o 



IOS# 

\ 

controller type 



device type 



Specifies minor device. Possible values are as 
follows: 

Type Description 

0-31 This number can be any unique 
number between 0 and 31. 

Specifies the IOS on which the drive resides. 
Possible values are 0 through 15. 

Specifies the controller on which the drive 
resides. Possible values are as follows: 

Type Description 



8 
9 

10 



I/O processor 
PERTEC controller 
SCSI controller 



Specifies device being used. Possible values 
are as follows: 

Type Description 

6 STK square tape 4220 or STK 

18-track square tape (SCSI) 

64 QIC tape device (SCSI) 

6 5 EXABYTE tape device (SCSI) 

6 6 9-track round tape (PERTEC) 



SG-5201 7.0 



Cray Research, Inc. 



79 



Online Tape System [A] 



UNICOS Installation Guide for CRAYY-MPEL Computer Systems 



Variable 
controller # 



device # 



logical unit # 
rewind status 



density 



Description 

Defines controller being used. Possible values 
are as follows: 

Type Description 
0 I/O processor 

0-7 SCSI and PERTEC 

Device ID number. Possible values are as 
follows: 

Type Description 



0-3 

0- 6 

1- 6 



PERTEC 
SCSI 

I/O processor 



Specifies the device logical unit number for 
SCSI devices. Possible values are 0 through 7. 

Specifies whether the device is a rewind or 
no-rewind device. Possible values are as 
follows: 

Type Description 

0 Rewind device 

1 No-rewind device 

Specifies whether the device (9-track only) will 
write tapes in high density or low density. 
Possible values are as follows: 

Type Description 



High density (6250 b/i) 
Low density (1600 b/i) 



Sample character Table 5 shows example command lines that create special 
special files character files for various devices and configurations. 

A.3 



80 



Cray Research, Inc. 



SG-5201 7.0 



UNICOS Installation Guide for CRAY Y-MP EL Computer Systems 



Online Tape System [A] 



Table 5. Example special character file command lines 



Device Configuration Command line 



QIC 




mknod 


/dev/rpqOl 


c 


43 


0 


0 


8 


64 


0 


1 


0 


0 


0 






mknod 


/dev/nrpqOl 


c 


43 


1 


0 


8 


64 


0 


1 


0 


1 


0 


EXABYTE 


Attached to the IOP 


mknod 


/dev/rpe02 


c 


43 


2 


0 


8 


65 


0 


2 


0 


0 


0 




SCSI bus 


mknod 


/dev/nrpe02 


c 


43 


3 


0 


8 


65 


0 


2 


0 


1 


0 


EXARYTE 

±Ux\Jr\.XJ X A. Hi 




1LLJS.11 w L4. 






43 


4 


o 




6R 


n 


o 


n 


n 

V-/ 


n 




VME SCSI controller 


mknod 


/dev/nrse02 


c 


43 


5 


0 


10 


65 


0 


2 


0 


1 


0 


Two SCSI 


One SCSI ID 


mknod 


/dev/rssOOO 


c 


43 


6 


0 


10 


6 


0 


0 


0 


0 


0 


square 


number and 


mknod 


/dev/rssOOl 


c 


43 


7 


0 


10 


6 


0 


0 


1 


0 


0 


tapes 


attached to the VME 


mknod 


/dev/nrssOOl 


c 


43 


8 


0 


10 


6 


0 


0 


1 


1 


0 




SCSI controller 


mknod 


/dev/nrssOOO 


c 


43 


9 


0 


10 


6 


0 


0 


0 


1 


0 


Two SCSI 


Different SCSI ID 


mknod 


/dev/rssOOO 


c 


43 


10 


0 


10 


6 


0 


0 


0 


0 


0 


square 


numbers and 


mknod 


/dev/rss010 


c 


43 


11 


0 


10 


- 6 


0 


1 


0 


0 


0 


tapes 


attached to the VME 


mknod 


/dev/nrssOOO 


c 


43 


12 


0 


10 


6 


0 


0 


0 


1 


0 




SCSI controller 


mknod 


/dev/nrss010 


c 


43 


13 


a 


10 


6 


0 


1 


0 


1 


0 



SG-5201 7.0 



Cray Research, Inc. 



81 



Panics and File System Crashes [B] 



If your CRAY Y-MP EL system experiences an IOS assertion panic 
or a UNICOS system panic, you should perform IOS and UNICOS 
dumps to save the data in your system's memory and determine 
the cause of the panic. 

The information retrieved from a system dump provides data 
that you can use to determine the cause of the panic. Therefore, 
if a system panic occurs, you should follow specific procedures to 
ensure a good system dump for complete data retrieval. 

This appendix describes the procedures for conducting IOS and 
UNICOS dumps, and it provides procedures for recovering from a 
root (/) file system crash. 



• IOS processor fault panic 

• UNICOS panic 

An IOS assertion panic indicates that the IOS software has 
encountered a catastrophic problem. When this occurs, the 
console displays a message similar to the following indicating 
the cause of the problem (n is the IOS number): 

IOSn ASSERTION PANIC : error message text 

An IOS processor fault panic indicates some type of unexpected 
hardware condition. The IOS error message will be followed by a 
register dump: 

IOSn. : error message text 
register dump 



Types of panics 

4.12 



There are three types of panics: 
• IOS assertion panic 
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A UNICOS panic occurs when the UNICOS operating system 
encounters a catastrophic problem. In such a case, a message 
similar to the following, indicating the cause of the problem, will 
be displayed on the console: 

IOSra NOTICE : date time UNICOS PANIC : error message text 



IOS assertion 
panic 

B.l 



When either and IOS assertion panic or an IOS processor fault 
panic occurs, the IOS PROM code starts executing in the affected 
IOS. The BOOT> prompt is displayed, if the affected IOS is the 
master IOS. For both of these types of errors, an IOS dump of 
the IOS issuing the panic is automatically performed by the 
CRAY Y-MP EL system. However, if it is necessary to perform an 
IOS dump manually, follow these steps to ensure a good system 
dump: 

1. Issue the iosdump command for each IOS in your 

CRAY Y-MP EL system. See "IOS dumps," following, for more 
information. 



2. Reload each IOS by executing the reload command. 

3. Dump the mainframe memory and registers by following the 
instructions in "Using the mf dump command on 

CRAY Y-MP EL systems," page 87. 



IOS dumps The iosdump command saves both the memory of the IOPs and 

B 2 " the I/O buffer board (IOBB) memory to the small computer 

system interface (SCSI) hard disk. Invoke the iosdump 

command at the BOOT> prompt. 

The format of the iosdump command follows: 



iosdump [-n filename] [-s size] 



The arguments are optional. The IOS generates a default file 
name and the iosdump command halts an operating IOS. 

The command lines that follow use the iosdump command: 
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BOOT> iosdump 

Saving IOS dump to /ADM/DUMPO /D03 1992 . 0 .. .done 



The following example uses the -n option, which lets you specify 
a file name for the contents of the dump: 



BOOT> iosdump -n /adm/ iosdump 1 

Saving IOS dump to /ADM/ IOSDUMPl ... done 



You must use the rcmd command to dump IOSs other than IOSO. 
This command cannot be run from the BOOT> prompt. 



IOS> rcmd ios4 iosdump 

Saving IOS dump to /ADM/DUMP4 /D03 1992 . 0 .. .done 



If an IOS panic has occurred in the master IOS (IOSO), you will 
not be able to take a dump of slave IOSs without reestablishing 
communications between the master IOS and the slave IOS. You 
must be careful not to destroy information contained on the 
slave IOS. Reloading the IOSs after the panic using the default 
configuration file will destroy information necessary to analyze 
the cause of the panic. Use the following steps to dump slave 
IOSs after an IOSO panic. The IOS prompt should be BOOT>. 

1. Save the old configuration file (/conf ig) in conf ig . bak. 

# cp /config / conf ig. bak 

2. Change the configuration file to boot a single IOS. Edit 
/config and remove all information about slave IOSs. Only 
IOSO information should remain in the /config file. 

If you have saved a copy of this file from a previous instance 
of taking IOS dumps (see step 7), you can copy this saved file 
(/config. 0) to /config. 



SG-5201 7.0 



Cray Research, Inc. 



85 



Panics and File System Crashes [B] 



UNICOS Installation Guide for CRAY Y-MP EL Computer Systems 



3. Load IOSO. Issue the IOS command load. 

4. Initialize the inter-IOS channel to the slave IOS. This step is 
necessary to establish communications between the master 
IOS and the slave. Use the IOS command iosinit to 
establish this link. The format of this command follows: 

iosinit iosiV SN 

where N is the is slave IOS number (1, 2, 3, ...) and SN is the 
serial number of the Heurikon IOP board in the slave IOS. 
This serial number can be obtained from the /conf ig . bak 
file created in step 1. For example, to dump IOS2, find the 
entry in the /conf ig . bak for 10 S2. It will look like: 

I0S2: 1594 

The number 1594 is the serial number. In this example, the 
iosinit command would be as follows: 

iosinit ios2 1594 

5. Dump the slave IOS. Use the IOS command rcmd to dump 
the slave IOS (N is the number of the slave IOS): 

rcmd iosiV iosdump 

6. To dump other slave IOSs, repeat steps 4 and 5 using the 
appropriate IOS number. 

7. Restore the original configuration file. When all IOS dumps 
have been taken, save the new configuration for future use. 

# cp /config /config.O 

Next, move the original IOS configuration file back into the 
default location: 

# cp /config. bak /config 

8. Reload the IOS. Use the IOS command reload to reload the 
IOS with the standard configuration. 

If a mainframe dump is also desired, you may now proceed. See 
subsections B.3 and B.4 for information on taking a mainframe 
dump. If a mainframe dump is not needed, you may continue 
with booting the system as usual with the IOS command boot. 
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UNICOS dumps You should perform a system dump with each UNICOS or IOS 

g 3 system panic. To perform a system dump, you must have 

allocated disk space to receive the dump. That partition is 
usually called /dev/dsk/dump. The size of /dev/dsk/dump 
may vary, but it must be large enough to contain the dump. You 
must also initialize /dev/dsk/dump before each use. Usually, 
the initialization of the dump partition and copying of the dump 
are accomplished in the /etc/coredd start-up script. 

When performing a system dump, you will use the following 
commands: 

Command Function 
/etc/coredd Start-up script 

/ e t c / i dmp Initializes the dump partition 

/ e tc / cpdmp Copies the dump from / dev / dsk / dump 

to a file for subsequent processing 

/etc/crash Analyzes the dump file 

See the UNICOS Administrator Commands Reference Manual, 
publication SR-2022, for more information the on coredd, idmp, 
cpdmp, and crash commands. 



Using the mf dump 
command on 
CRAY Y-MP EL 
systems 



B.4 



The memory dump utility, mf dump, does not write to the dump 
disk partition if that partition is not formatted properly. To 
initialize the dump partition, issue the UNICOS idmp command. 
You must initialize the dump partition before the system is down 
because it cannot be done afterward; the /etc/coredd script 
usually does this during UNICOS startup. 

Before taking a mainframe dump on the CRAY Y-MP EL system, 
you should save the scan chains from the CPUs. This is a 
temporary workaround to retrieve the hardware registers 
because mf dump will not do that yet. To save the scan chains on 
a four-CPU system, enter the following commands at the I0S> 
prompt: 



IOS> 


elk off 






IOS> 


bscan o 


0 


/ tmp/cpuO 


IOS> 


bscan o 


1 


/tmp/cpul 


IOS> 


bscan o 


2 


/ tmp/cpu2 


IOS> 


bscan o 


3 


/ tmp/cpu3 


IOS> 


elk on 
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If your system has fewer than four CPUs, enter the bscan 
commands that relate to the CPUs you have installed. The 
bscan command saves the scan chain information on the IOS 
SCSI disk in file /tmp/cpux in the preceding example. You must 
analyze this file along with the dump that mf dump creates. After 
saving the scan chains, reload the IOS before executing the 
mf dump command. As of the UNICOS 7.0 release, you no longer 
need to reload the IOS before trying to boot UNICOS. 

An example of the execution of mf dump follows. Comments are 
preceded by a # and do not actually appear when running 
mf dump. 



Note 

The mf dump command will prevent you from accidentally 
overwriting unprocessed dumps. If your dump partition 
contains an unprocessed dump, indicated by the mf dump error 
message, Unable to force dump, you can force a dump by 
using mf dump -F command. As of the UNICOS 7.0 release, you 
no longer need to reload the IOS between executions of the 
mf dump command. 

See the CRAYY-MPEL System-specific Administrator Commands 
Reference Manual, publication SR-2408, for more information on 
the mf dump command. 
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# The -q option forces these questions. The information you enter is stored in 

# /sys/mfdump . arg. If that file does not exist, mfdump will enter query mode 

# automatically. After mfdump . arg is created, you may use mfdump with no 

# arguments and bypass these questions. 
# 

IOS> mfdump -q 

Enter hardware configuration information and dump memory size: (in 

megawords : legal values are 32, 64, 128, 256) 

64 

Number of cpus : (legal values: 1, 2, 3, 4, 5, 6, 7, 8) 
4 

Do you want a register dump? (y/n) [y] 

y 

Do you want a system register dump? (y/n) [n] 

y 

Do you want to dump the ublocks? (y/n) [y] 

y 

# 

# mfdump lets you dump up to four noncontiguous sections of memory. 
# 

Enter the memory ranges to dump (in words) . 

Enter memory range 0 . 

Low: 

0 

High: 
16000000 

Enter memory range 1 . 

Low: 

0 

High: 
0 

Enter memory range 2 . 

Low: 

0 

High: 
0 

(continued) 
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Enter memory range 3 . 

Low: 

0 

High: 
0 



Enter dump device information. 

This information is in the /CONFIGURATION file on the UNICOS system. 
# 

# This is the mainframe channel number (in decimal) that connects to the IOS where 

# the disk dump partition resides. CRAY Y-MP EL systems that have only one IOS or 

# a CRAY Y-MP EL system in which the dump partition is on IOSO, the channel 

# number is 16 (020). On CRAYY-MPEL systems that have multiple IOSs, the 

# channel number is in octal in the configuration file and must be converted to 

# decimal. 
# 

Enter the channel number: 

16 

# 

# This is the MIOP number of the controller in which the dump partition resides. 
# 

Enter the IOS number (0-15) : 
0 

Enter the controller number: 
0 

Enter the dump disk type (18 = DAS, 19 = DAS-2 , 16 = ESDI, 17 = DD3 , 

2 0 = DD4) : 

17 



Enter the unit number: 

0 

# 

# Enter the starting block and length of the disk partition. 
# 

Enter the starting block: 
0 



Enter the length in blocks : 

131072 (continued) 
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# 

#m£ dump redisplays your answers and asks whether you want to save your answers 
^permanently before performing the dump. 



If your root (/) file system becomes corrupt, you must determine 
the cause. If the corruption is because of a bad disk or other 
hardware problem, you must remedy this before reloading the 
software. 

Use the following steps to recover from a root (/) file system 
crash. This procedure assumes that a back-up copy of the root 
(/) file system (bkroot) is available. 

1. Load the IOS by entering the following: 

BOOT> load 

2. Edit the configuration file so that it to boots from bkroot, as 
follows: 

IOS> ed /sys/conf ig.uni 

3. Modify the values for ROOTDEV and PIPEDEV to point to 
bkroot rather than root (/), as follows: 

ROOTDEV = bkroot; 
PIPEDEV = bkroot; 

4. Boot UNICOS by using /dev/dsk/bkroot as the root (/) 
device, as follows: 

IOS> boot 

5. Replace the corrupt root (/) file system with a clean copy 
(that is, bkroot) by entering the following: 

# dd if=/dev/dsk/bkroot of =/dev/dsk/root bs=128k 



Note 

You must configure bkroot and root with the same number of 
disk blocks that are in the IOS conf ig . uni file. 



Recovery from a 
root (/) file system 
crash 

B.5 
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6. Edit the configuration file on the IOS to point back to root (/), 
and reboot the system by using /dev/dsk/root as the root 
(/) device. 



Alternative root 
(/) file system 
recovery 
procedure 

B.6 



Except for the value of ROOTDEV, this procedure is similar to the 
first. In this procedure, you must change ROOTDEV to iroot, 
rather than bkroot. When you are operating in iroot, you can 
use the restore command to restore root (/) from your most 
recent back-up tape. 

If there is no backup root or iroot file system on disk, place the 
release tape into the QIC tape device and enter the iboot 
command. This boots an iroot file system in DDRAM (not disk). 
A /sys/conf ig .uni file must be present to run this utility. 
After booting to single-user mode, run the els_install utility 
to re-install the 7.0 package. Because the root (/) file system on 
the release tape is generic, any customization, user validations, 
and so on are lost and must be re-created. It is recommended, 
therefore, that you keep /bkroot up-to-date as you make 
changes to the root (/) file system. 
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This appendix describes the settings used to define your WYSE 
terminal settings. 



Defining your 

console settings 

c.i 



To define your WYSE console settings, use the following terminal 
settings: 



Feature menu 
Display 

Status line 
General 

Communication 



Tabs 



Settings 

Columns = 80 
Lines = 25 

Off 

Terminal type = VT100 

Baud = 19200 
Data/stop = 8/1 
Parity = NONE 
Handshakes = XON/XOFFl 

Default tabs = every 8 columns 

(tabs must be reset after every power-up) 
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Beginning with the release 8.9 of the CRAY Y-MP EL I/O 
subsystem software, two additional fault-resilient features for 
disk array subsystem controllers (DAS) are available. These 
features apply to DAS-1 and DAS-2 controllers. As part of the 
installation process, you must initialize DAS controllers on your 
CRAY Y-MP EL system. 

The first feature automatically remaps bad sectors during 
system operation. If a drive exceeds the threshold for 
uncorrected read or write errors during system operation, the 
second feature allows your CRAY Y-MP EL system to switch 
automatically to an available spare DAS (hot spare). 

You must initialize the threshold values and error counts when 
you install the CRAY Y-MP EL I/O subsystem software. After it is 
initialized, these threshold values and error counts can be 
viewed and, if necessary, changed as described in the subsections 
that follow. 



DAS initialization 

D.l 

If your DAS controller is connected to IOS 0, enter the following: 

dwconfig D00 / install /das_init . cfg 
If your DAS controller is connected to IOSrc, enter the following: 
rcmd iosra dwconfig D00 /install/das_init . cf g 



When installing the CRAY Y-MP EL I/O subsystem software, you 
must initialize the threshold values and error counts. You do not 
have to perform this initialization again unless you completely 
reinitialize the DAS controller. To initialize your DAS controller, 
use the command line that is appropriate for your configuration. 
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Viewing threshold 
and error counts 

D.2 



To view or review the DAS threshold and error counts, enter the 
command line that is appropriate for your configuration. 

If your DAS controller is connected to IOS 0, enter the following: 

dstat dOO 

If your DAS controller is connected to IOS n, enter the following: 
rcmd iosra dstat dOO 



IOS> dstat dOO 

Driver Strategy Numbers : 

Number of driver calls made : 8933 
Number of chained calls made : 277 
Times requests were suspended: 4323 

DAS ctlr 0 bank 0 [DOO], type = DDLDAS 



DAS Driver Numbers : 

Total number of DAS requests 
Total number of cntrlr requests 
Current number of DAS requests 
Outstanding controller requests 
Average controller command depth 
Number of requests waiting 
Total requests which have waited 
No. of times req's were stacked 
No. of times max req's stacked 
No . of times dma suspended 
List of all tsb's 
List of current tsb's 



1442 

1283 

0 

0 

0 

0 

24 
217 
25 
0 

: 0x32fel04 
0x3307ac4 



Bank 0 status 83 ff , Read err threshold = 10, Write err threshold = 1 
Substitute = none, Disable = none 

Drive status Read errs Write errs 



drive 


1 


30 


0 


0 


drive 


2 


30 


0 


0 


drive 


3 


30 


0 


0 


drive 


4 


30 


0 


0 


drive 


5 


30 


0 


0 


drive 


6 


30 


0 


0 


drive 


7 


30 


0 


0 


drive 


8 


30 


0 


0 


drive 


9 


30 


0 


0 


drive 


10 


30 


0 


0 



IOS> 
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For further details about the dwconf ig and dstat commands, 
see the CRAY Y-MP EL System- specific Administrator Commands 
Reference Manual, publication SR-2408. 



Changing If y° ur site does not use hot-spare switching, set the threshold 

threshold values counts to 0. You may choose to use a different value, which is 

D 3 limited only by a maximum byte size of 255. If you intend to 

change the values, copy the / install /das_init . cf g text file 
to a new file name and edit it by using the ed command. After 
editing the new file, execute the appropriate dwconf ig 
command to load the values from the file into the DAS controller. 



Bad sector 
remapping 

D.4 



The DAS tracks each bad sector that it encounters. The bad 
sectors are transparently logged with address information in the 
DAS Growth Error table (GET) and an error packet is sent to 
UNICOS for system logging. 

You can slip or remap the bad sector by issuing the df ormat 
command. This merges GET with the DAS Raw Flaw table (RFT) 
information and clears GET. The DAS controller refers to this 
process as Format Function Level 5. For more information 
about df ormat, see the CRAY Y-MP EL System-specific 
Administrator Commands Reference Manual, publication 
SR-2408. 



DAS hot-spare 
switching 

D.5 



If a drive exceeds the threshold for uncorrected read or write 
errors during system operation, the system will switch 
automatically to a DAS hot spare. Parity reconstruction is used 
to reconstruct the hot spare with the data from the failing disk. 
This procedure takes approximately 45 minutes. 

Threshold values and individual running error counts for each 
drive in the array are stored in an unused portion of the DAS 
controller memory. To provide an accurate long-term record of 
disk errors, this data is retained if your system is rebooted or 
powered down. 
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Note 

The release software defaults are set for ten unrecovered reads 
per disk and one unrecovered write per disk; however, these 
thresholds can be changed for individual site preferences (see 
"Changing threshold values," page 97). 



Both UNICOS and IOS make error log entries when 
reconstruction begins and again when reconstruction is 
complete. If the reconstruction operation encounters 
uncorrectable errors on individual sectors, they are reported to 
the IOS console and the UNICOS error log. At this time, the 
system administrator must restore the lost files from the 
back-up files. 

After a drive is switched out and the hot spare is in use, the 
system administrator must contact the CRAY Y-MP EL system 
local field engineer who will fix the failing drive. When 
appropriate, the repaired or replaced drive should be restored on 
your CRAY Y-MP EL system. 
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The UNICOS multilevel security (MLS) feature provides 
mechanisms to protect both system integrity and sensitive 
information. Design specifications for the UNICOS MLS feature 
were derived from the Department of Defense Trusted Computer 
System Evaluation Criteria (DoD 5200.28-STD). For more 
information on MLS, see UNICOS System Administration, 
publication SG-2113. 

This appendix provides procedures for configuring MLS on your 
preinstalled UNICOS 7.0 system and for upgrading your MLS 
system to 7.0. 



Configuring MLS 
on your 
pre-installed 
UNICOS 7.0 system 

E.l 



The following instructions describe how to configure the UNICOS 
MLS feature on your preinstalled UNICOS 7.0 system. These 
procedures may be executed at any time in single-user or 
multiuser mode. If the system is in single-user mode, make sure 
/usr and /usr/src are mounted. 

For additional information on new MLS features for 7.0 and how 
to set up secure NFS, see the "UNICOS Multilevel Security" 
section of the UNICOS 7.0 Release Overview for CRAY Y-MP EL 
Systems, publication RO-5200 7.0. 

1. Enter the UNICOS Installation and Configuration Menu 
System. 

Enter the menu system by executing the following 
commands: 



# cd /etc/install 

# ./install 
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2. Enable MLS. 

To enable MLS, set the following menu selection to ON, then 
I tab | down to the Activate the configuration action 
and press IreturnI : 

Menu Option to select 

Configure System ==> 
Major software configuration ==> 
Multilevel Security (MLS) ON 



Activate the Configuration. . . 

If you also want to administer your system security by using 
the menu system, enable menu system configuration by 
setting the following selection to YES: 

Menu Option to select 

Configure System ==> 

Configurator automation options => 
Multilevel security (MLS) configuration YES 

=> 

3. Import the MLS configuration files. 

To verify that the installation menu files are up-to-date with 
the configuration files on your system, you must import your 
MLS configuration files. 

Before importing the MLS configuration files for the first 
time, you must modify the import table to refer to the 
template sec labs . c file, as follows: 

Utilities ==> 

Import utility ==> 
Import table ==> 

Go to the seclabs . c entry in the Import Table and 
change the first argument from: 

/usr/src/uts/cf /seclabs . c 

to: 

/usr/src/uts/cf .SiV/seclabs . c 
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Then set the Import? selection to Yes. 

Now go to the hosts . nal entry in the Import Table and 
set the Import? selection to YES. 

Then proceed with the import as follows: 

Configure system ==> 
Multilevel Security (MLS) Configuration ==> 
Import the security configuration ==> 

After the import is complete, reset the value in the Import 
table back to /usr/src/uts/cf .SiV/seclabs . c. This can 
be done by executing the following menu action: 

Utilities ==> 

Import utility ==> 
Import option ==> 



4. Set up the network access list (NAL). 

If you plan to permit TCP/IP network access to your UNICOS 
system (for example, telnet or ftp), entries for the 
following Internet address(es) must appear in the network 
access list (NAL), as follows: 

Local host (127.0.0.1) 

Local network interfaces for all directly 
connected networks 

To set up entries in your hosts . nal file, go to the following 
submenus. The security option should be set to either NONE, 
BASIC, or CIPSO, depending on your security policy. 



Reload default import table 



Menu 



Options to select 



Configure system ==> 

Multilevel Security (MLS) Configuration ==> 
Network Security Options 
Network Access List (NAL) ==> 
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Add a new entry by pressing n. Modify this new entry by 
pressing IreturnI while the cursor is on the new entry just 
added. Fill in the following submenu: 

Menu Options to select 

Network type TCP 
Host name / address or USCP station I.D. xxxx 

Minimum security level 0 

Maximum security level 16 

Minimum security compartments 0 

Maximum security compartments 0777777777777777777777 

Receive? YES 

Send? YES 

Network trap? NO 

Security class Bl 

Security option NONE 

Authority- in 

Authority-out 

Domain of interpretation 

5. Configure other MLS options. 

Other MLS options can be configured at this time. Select and 
modify the submenus under the following menu: 

Configure system ==> 

Multilevel Security (MLS) configuration ==> 

The functions of the submenus are as follows: 

• Modify the system console options: 

System Options ==> 

• Modify the Login / Password options: 

Login / Password options ==> 

• Modify your disk scrubbing policy: 

Disk options ==> 

• Modify the location of your security log, the name of your 
security log, or what is audited: 

Security log file configuration ==> 
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• Define site-specific compartments or levels: 
Site labels configuration ==> 

6. Activate the security configuration. 

After you have made your selections, you must activate the 
new configuration with the following menu: 

Configure system ==> 

Multilevel Security (MLS) Configuration ==> 
Activate the security configuration . . . 

7. Label network interfaces and routes. 

You must configure the security levels and compartments on 
the networking interfaces and TCP/IP static routes. 

If you do not label these interfaces and routes, the authorized 
security levels and compartments of users who connect to the 
UNICOS system will be set to 0 and None. The steps are as 
follows: 

a. Import the current network configuration, as follows: 

Configure system ==> 
Network configuration ==> 
General network configuration ==> 
Import general network configuration . . . 

b. Label the network interfaces in the following submenu: 

Configure system ==> 

Network configuration ==> 
General network configuration ==> 
Network interface configuration ==> 

Under this submenu, you must define each of your network 
interfaces; for each interface, set the minimum and 
maximum level and compartments. 

Your routes will be labeled automatically with the range of 
labels on your interfaces. 
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When you have completed your general network 
configuration, activate the new configuration: 

Configure system ==> 

Network configuration ==> 
General network configuration ==> 
Activate general network configuration . . . 

8. Remove old TFMgmt compartments. 

If your site has used the old TFMgmt style, you must upgrade 
to the new TFMgmt style (if you have not used the old 
TFMgmt style, proceed to step 9). 

To remove reserved compartments, use the following menu: 

Configure system ==> 

Multilevel security (MLS) configuration ==> 
Site labels configuration ==> 
Compartments 

Typically, you will want to remove from this menu the six 
reserved compartments used by the tsubcmd and udbcmd 
commands: secadm, sysadm, sysops, netadm, crayri, and 
unicos. If, however, your site used any of these reserved 
compartments to protect sensitive data other than the files 
labeled by the tsubcmd and udbcmd commands, you should 
not remove the definitions for those compartments. 

Any reserved compartments that you remove can be used for 
future compartment expansion. After a compartment 
definition has been removed, you can reference that 
compartment only by its octal representation. 



Note 

Before reusing any removed compartment bits, use the spset 
command to remove and relabel all file labels that reference the 
removed compartments (see the spset(l) man page for more 
information). 



9. Build an MLS kernel and transfer it to the expander disk. 

To link a new MLS kernel, enter the Build/ install 
selection of the install tool and set the appropriate options, as 
follows. 
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After all options have been selected, select "Do the 
Build. ..." to build the new kernel, as follows: 



Menu 



Option to select 



Build/install system ==> 

/usr/src reconfiguration files ==> 

Build action to take 

Build object 

Components to build 

Major components selection ==> 

Specific component to build 

Do the build . . . 

Restart the build ==> 

Review last build error summary . . 

Escape to a chroot shell . . . 



uts 



install 
all objects 
specific component 



Move the new kernel to the expander disk. 

If you have not made a back-up copy of your current kernel, 
either make one now or transfer the kernel with a unique 
sufRx. 

If you want to make a back-up copy now, escape to the shell 
and execute the following commands: 

# |coNTROL-a1 (toggles to the IOS console) 

IOS> mv sys/unicos .ymp sys/unicos .old 

IOS> icoNTROL-'al (toggles to the UNICOS console) 

Return to the install menus and press M to go to the main menu. 
Enter the Utilities menu and select file transfer utilities. 
Define where to transfer the new kernel and any other specific 
information needed as shown in the following example. When 
all options have been specified, select the menu selection Do 
the transfer to the expander. 



Menu 



Option to select 



Utilities ==> 

File transfer utilities ==> 
Expander file transfers ==> 



Transfer UNICOS Kernel to the expander? 
Transfer UNICOS load map to the expander? 
Transfer CSL param file to the expander? 
Transfer IOS Kernel to the expander? 
Transfer diagnostics to the expander? 



YES 
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Menu 



Option to select 



Expander directory name 
Expander filename suffix 



sys 
.ymp 



Do the transfer to the expander 
Create an IOS deadstart tape . . 
Create an offline diag tape . . . 



You can now exit the install tool and continue with MLS 
configuration. 

10. Set up the security log device file. 

Before booting the new kernel, you need to make sure that 
the /dev/slog security log device file exists. If this device 
file does not exist, it must be created, as follows: 

# /etc/znknod /dev/slog c 20 0 

The /dev/slog file is a pseudo device in which all security 
events are recorded. If this device is not available before the 
system is booted, an error message from the security log 
daemon is displayed on the console. 

11. Label necessary file systems. 

Label all file systems that are to be mounted under the MLS 
kernel with the appropriate security labels for your site. You 
will want to label the root ( / ) , /usr, /usr/src, and 
/usr/home file systems at a minimum. 

If your site uses nonzero levels and compartments, use the 
following guidelines for labeling file systems: 

a. Label the root file system with all the security levels and 
compartments that are assigned to users on the MLS 
system. This is necessary because pipes are usually 
allocated through the root device. Also, tty devices change 
labels to match that of the user through the root device. 

b. Label the file systems in which NQS and mail files reside 
with all the security levels and compartments assigned to 
the users on the MLS system. The /usr/tmp and /tmp 
file systems must also be labeled with all the security 
levels and compartments. 
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Your site may need to specify a maximum security level and 
authorized compartment values that are nonzero. For 
example, if your site plans on using security levels 0 through 
16 and compartment 04700, your root and other file systems 
must be labeled as follows: 

# /etc/labelit -s -1 0 -u 16 -c 04700 /dev/dsk/root 

# /etc/labelit -s -1 0 -u 16 -c 04700 /dev/dsk/usr_tmp 

# /etc/labelit -s -1 0 -u 16 -c 04700 /dev/dsk/tmp 

12. Shut down the system and boot the new MLS kernel. 

Shut the system down to single-user mode, and reboot your 
new kernel by entering the following: 

# cd / 

# /etc /shutdown 0 

# sync; sync; sync 

# l control -a] (toggles to the IOS console) 



Note 

If you have transferred your kernel with a unique suffix, make a 
back-up copy of your old kernel, and rename the new kernel 
unicos .ymp. 

IOS> mv sys /unicos. ymp sys /unicos .old 
I0S> mv sys/unicos.mls sys /unicos .ymp 



IOS> boot {Boot the new kernel) 
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13. Label trusted binaries and files. 

The tsubcmd and udbcmd commands must be run to label 
the trusted binaries and files. When running these 
commands, you must use the -1 option (label only). This will 
properly label the necessary MLS sensitive files without 
removing the files from their target locations. First mount 
the /usr file system, then run the tsubcmd and udbcmd 
commands as follows: 

# /etc /mount /dev/dsk/usr /usr 

# /etc/tsubcmd -1 

# /etc/udbcmd -1 

14. Create a security administrator account. 

If you are performing an initial installation of UNICOS 7.0, or 
upgrading to UNICOS 7.0 MLS from a non-secure UNICOS 6.1 
system, you must create an account in the UDB for system's 
security administrator, using either the udbgen(8) or the 
nu(8) command. 

A security administrator should be given the following UDB 
values, at a minimum: 

• valcat : secadm, sysf il : 

• permits : install , reclsfy , suidgid: 

• maxcls : 16 : 

In addition, if you want the security administrator to be able 
to reclassify user files, you should give the security 
administrator account all security levels and defined 
compartments for your system. 

15. Label console devices. 

For UNICOS 7.0, the system console device entries under the 
/dev directory must be labeled as follows: 

Use the -L and -C options to the /etc /get ty command to 
specify the level and compartment ranges for the system 
console device /dev /console. 
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To label your console device, edit the /etc/inittab file as 
follows: 

# vi /etc/inittab 

co: rrespawn: /etc/getty -L 0-16 -C 0-077 console console 

16. Configure workstation access list. 

The spwal(8) command creates workstation access list (WAL) 
entries for the UNICOS MLS system. Because the WAL is not 
required, you may configure it at a later time. If, however, 
you want to configure your WAL entries at this time, see the 
spwal(8) man page for more information. 

17. Create CIPSO Security Label Translation table. 

If the local networks at your site support the Commercial IP 
Security Option (CIPSO), you must create the security label 
translation tables, using the spsomap(8) command. The 
translation tables that spsomap(8) creates are read at boot 
time; therefore, you must reboot the system after creating (or 
modifying) the tables for the entries to take effect. See the 
spsomap(8) man page for more information. 

18. Arrange for NAL initialization at system startup. 

When the UNICOS 7.0 system enters multiuser mode, you 
must initialize the kernel's network access list (NAL) table by 
using the spnal(8) command. The default /etc/rc script 
supplied with UNICOS 7.0 does this for you. If you are not 
using the UNICOS /etc/rc script for your multiuser startup, 
you must arrange for the NAL initialization at system startup 
by including a line such as the following in your system 
start-up script: 

/etc/spnal -k /etc/hosts . nal 

See the spnal(8) man page for more information. 

19. Enter multiuser mode. 

You can now boot the system to multiuser mode by executing 
the following command: 

# init 2 
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20. Define each user in the UDB. 

At some point, the security administrator must define each 
user in the UDB. Proper definition of users in the UDB is 
critical to maintaining a trusted system. Each UDB entry 
defines the following: 

• Active integrity class 

• Authorized integrity class 

• Active integrity category 

• Authorized integrity categories 

• Active compartments 

• Authorized compartments 

• Active security level 

• Minimum security level 

• Maximum security level 

• Permissions 

The security administrator can use the nu(8) or udbgen(8) 
command to create UDB entries or to modify security 
components of existing UDB entries. The nu(8) command 
creates and initializes a home directory for newly created 
accounts; the udbgen(8) command does not. 

You must also set the proper security labels on the home 
directories of user accounts to have a nonzero default level or 
a nonnull default compartment set (or both). Although the 
nu(8) command creates a home directory and related files for 
a new account, it cannot set the directory to a nonnull label. 
You can set labels on these created directories and files by 
using the spset(l) command. 

This work should be done in single-user mode. To do so, you 
must manually mount the file systems on which the nu(8) 
command will create the user login directories. Alternatively, 
you may bring the system up to multiuser mode without 
configuring the network, to initialize the security 
classifications of the users without permitting access to the 
system before proper security levels are established. 
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The following instructions describe how to complete the MLS 
portion of upgrading your system to 7.0. 

For additional information on new MLS features for 7.0 and how 
to set up secure NFS see the "Multilevel Security" section of the 
UNICOS 7.0 Release Overview for CRAY Y-MP EL Systems, 
publication RO-5200 7.0. 

At this point, you should have already booted a new 7.0 MLS 
kernel and be in single-user mode. 

1. Label UNICOS 7.0 file systems correctly. 

You must correctly label the following UNICOS 7.0 file 
systems for the UNICOS 7.0 MLS system to function properly: 

• root (/) 

• The file system(s) in which the following directories reside: 

/usr/mail 
/usr/spool/NQS 
/usr /spool /USCP 

• / tmp and /usr / tmp 

You must label these file systems with all of the security 
levels and compartments that are assigned to the system's 
users. This is necessary for the root file system because 
pipes are usually allocated through the root device, and 
because tty devices, which reside on the root device, change 
labels to match those of a user connecting to the UNICOS 7.0 
MLS system. Labeling is necessary for the other file systems 
because users create files in them. 

2. Convert your UNICOS 6.1.6 format /etc/hosts . nal file to 
the new UNICOS 7.0 format. Enter the following commands 
to do this: 

# cd /etc 

# /etc/spnal -c hosts. nal hosts. nal 

3. Enter the menu system. 

Use the following commands to enter the UNICOS 
Installation and Configuration Menu System: 

# cd /etc/install 

# ./install 



Upgrading your 
MLS system to 7.0 

E.2 
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4. Import the MLS configuration files. 

To verify that the installation menu files are up-to-date with 
the configuration files on your system, you must import your 
MLS configuration files. 

Before importing the MLS configuration files for the first 
time, you must modify the import table to refer to the 
template sec labs . c file, as follows: 

Utilities ==> 

Import utility ==> 
Import table ==> 

Go to the sec labs . c entry and change its first argument 
from: 

/usr/src/uts/cf .SiV/seclabs . c 
to: 

/usr/src/uts/cf /seclabs . c 

Then set the Import? selection to Yes. 

Now go to the hosts . nal entry and set the Import? 
selection to Yes. 

Then proceed with the import as follows: 

Configure system ==> 

Multilevel Security (MLS) Configuration ==> 
Import the security configuration ==> 

After the import is complete, reset the value in the Import 
table backto /usr/src/uts/cf .SiV/seclabs . c. This can 
be done by executing the following menu action: 

Utilities ==> 

Import utility ==> 
Import option ==> 
Reload default import table . . . 

5. Set up the network access list (NAL). 

If you plan to permit TCP/IP network access to your UNICOS 
system (for example, telnet or ftp), entries for the 
following Internet address(es) must appear in the network 
access list (NAL): 
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• Local host (12 7. 0.0.1) 

• Local network interfaces for all directly connected networks 

To set up entries in your hosts .nal file, go to the following 
submenus. The security option should be set to either none, 
basic, or c ipso depending on your security policy. 



Menu 



Option to select 



Configure system ==> 

Multilevel Security (MLS) Configuration ==> 
Network Security Options ==> 
Network Access List (NAL) ==> 

Network type 

Host name / address or USCP station I.D. 

Minimum security level 

Maximum security level 

Minimum security compartments 

Maximum security compartments 

Receive? 

Send? 

Network trap? 

Security class 

Security option 

Authority- in 

Authority-out 

Domain of interpretation 



TCP 

snxxxx 
0 

16 
0 

0777777777777777777777 

YES 

YES 

NO 

Bl 

NONE 



6. Configuring other MLS options. 

Other MLS options can be configured at this time. Select and 
modify the submenus under the following menu: 

Configure system ==> 

Multilevel Security (MLS) configuration ==> 

The functions of the submenus are as follows: 

• Modify the system console options: 

System Options ==> 

• Modify the Login / Password options: 

Login / Password options ==> 
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• Modify your disk scrubbing policy: 

Disk options ==> 

• Modify the location of your security log, the name of your 
security log, or what is audited: 

Security log file configuration ==> 

• Define site-specific compartments or levels: 

Site labels configuration ==> 

7. Activate the security configuration. 

When you have made your selections, you must activate the 
new configuration, as follows: 

Configure system ==> 

Multilevel Security (MLS) Configuration ==> 
Activate the security configuration . . . 

8. Label network interfaces and routes. 

You must configure the security levels and compartments on 
the networking interfaces and TCP/IP static routes. If you do 
not label these interfaces and routes, the authorized security 
levels and compartments of users who connect to the UNICOS 
system will be set to 0 and none. 

First, import the current network configuration, as follows: 

Configure system ==> 

Network configuration ==> 
General network configuration ==> 
Import general network configuration . . . 

Next, label the network interfaces in the following submenu: 

Configure system ==> 

Network configuration ==> 
General network configuration ==> 
Network interface configuration ==> 

Under this submenu, you must define each of your network 
interfaces, and for each interface set the minimum and 
maximum level and compartments. 

Your routes will be labeled automatically with the range of 
labels on your interfaces. 
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When you have completed your general network 
configuration, activate the new configuration, as follows: 

Configure system ==> 

Network configuration ==> 
General network configuration ==> 
Activate general network configuration . . . 

9. Remove old TFMgmt compartments 

If your site has used the old TFMgmt style, you must upgrade 
to the new TFMgmt style (if you have not used the old 
TFMgmt style, proceed to step 10). 

To remove reserved compartments, use the following menu: 

Configure system ==> 

Multilevel security (MLS) configuration ==> 
Site labels configuration ==> 
Compartments 

Typically, you will want to remove from this menu the six 
reserved compartments used by the tsubcmd and udbcmd 
commands, which are secadm, sysadm, sysops, netadm, 
crayri, and unicos. If, however, your site used any of 
these reserved compartments to protect sensitive data other 
than the files labeled by the tsubcmd and udbcmd 
commands, you should not remove the definitions for those 
compartments . 

Any reserved compartments that you remove can be used for 
future compartment expansion. After a compartment 
definition has been removed, you can reference that 
compartment only by its octal representation. 



Note 

Before reusing any removed compartment bits, use the spset 
command to remove and relabel all file labels that reference 
the removed compartments (see the spset(l) man page for 
more information). 



10. You may now exit the UNICOS installation and configuration 
menu system. 
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11. Label console devices. 

For UNICOS 7.0, the system console device entries under the 
/dev directory must be labeled as follows: 

Use the -L and -c options to the /etc /get ty command to 
specify the level and compartment ranges for the system 
console device /dev/ console. You can also use the -m 
option to /etc/getty to indicate that the specified console 
device is a multilevel device. 

To label your console device, edit the /etc/inittab file as 
follows: 

# vi /etc/inittab 

co :: respawn: /etc/getty -L 0-16 -C 0-077 console console 

12. Configure the WAL 

The spwal(8) command creates workstation access list (WAL) 
entries for the UNICOS MLS system. Because the WAL is not 
required, you can configure it at a later time. If you want to 
configure your WAL entries at this time, see the spwal(8) 
man page for more information. 

13. Create CIPSO Security Label Translation table. 

If the local networks at your site support the Commercial IP 
Security Option (CIPSO), you must create the security label 
translation tables, using the spsomap(8) command. The 
translation tables that spsomap(8) creates are read at boot 
time; therefore, you must reboot the system after creating (or 
modifying) the tables for the entries to take effect. See the 
spsomap(8) man page for more information. 

14. Arrange for NAL initialization at system startup 

When the UNICOS 7.0 system enters multiuser mode, you 
must initialize the kernel's network access list (NAL) table by 
using the spnal(8) command. The default /etc/rc script 
supplied with UNICOS 7.0 does this for you. If you are not 
using the UNICOS /etc/rc script for your multiuser startup, 
you must arrange for the NAL initialization at system startup 
by including a line such as the following in your system 
start-up script: 

/etc/spnal -k /etc/hosts . nal 
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See the spnal(8) man page for more information. 

15. Enter multiuser mode. 

You can now boot the system to multiuser mode by executing 
the following command: 

# init 2 
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UNICOS kernel 
configuration 



F.l 



This appendix describes the steps for configuring a network 
device so that it is accessible to the UNICOS kernel. This portion 
of the configuration is the same regardless of what protocol 
family will be using the device. 

For CRAY Y-MP EL systems, this part of the configuration is 
usually done at the factory, so you should not need to alter the 
kernel configuration under most circumstances. However, you 
may have to change the kernel configuration if you add a new 
network interface or move a network interface from one IOS to 
another. 



Note 

The following instructions do not address configuring the HIPPI 
interface. Although the following sections provide information 
on parameters related to the HIPPI interface, they do not provide 
sufficient information to configure a HIPPI interface into 
UNICOS. Separate instruction will be provided when the HIPPI 
hardware is installed on your system. 



The comm_inf o Network interfaces are configured into the kernel when the 

structure kernel is linked. The comm_inf o structure in the 

F.l.l /usr/src/uts/cl/cf /conf .XXX. c file (where XXX is the 

serial number of your system) is where the network interfaces 

are defined. 

Figure 9, page 121, shows the fields and default values for the 
comm_inf o structure. The following paragraphs explain the 
meaning of each field. 
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Field 



Default value 



Driver 



IOS 
IOP 

Channel 



Device type 



Logical 
paths 



Device- 
dependent 



The name of the driver for the interface. 
Possible values are C0MM_EN_DRIVER for 
Ethernet, C0MM_FDDI_DRIVER for FDDI, 
C OMM_H Y_DR I VER for HYPERchannel, and 
COMM_HSX_DRIVER for HIPPI. 

The IOS number in which the controller is 
physical located. 

Not used on CRAY Y-MP EL systems. Set this 
field to zero for all entries. 

The channel determines which controller to 
use. This number is derived from a base 
number and an ordinal representing the 
controller's VMEbus address jumper setting. 

The base numbers are: HYPERchannel 0x00, 
HIPPI 0x00, Ethernet 0x10, and FDDI 0x2 0. 

Td obtain the ordinal channel value for a 
network controller, look at the message 
generated during the IOS load. For example, 
the Ethernet driver will report "Ethernet : 
Controller 0 - detected," where 0 is the 
controller's ordinal channel value. 

Combine the base and ordinal values together 
to create the channel number. For this 
example, the channel would be 0x10. Refer 
to Figure 9 for more examples. 

Type of interface: COMM_EN for Ethernet, 
COMM_FDDI for FDDI, COMM_N400 for NSC 
400-series HYPERchannel adapters, and 
COMM_HIPPI for HIPPI. 

Used only for HYPERchannel and HIPPI 
entries, in which case it is the number of 
logical paths available (set between 1 and 
16). For all other types, set to 0. 

Only used for HIPPI entries. For HIPPI, set 
this field to HXCF_HIPPI. For all other types, 
set to zero. 
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struct coiran_info coiraninf o [ ] 
/* drv, iso, iop, chan, 
{ COMM_EN_DRIVER , 0,0, 
{COMM_EN_DRIVER, 0, 0, 
{ COMM_EN_DRIVER , 0, 0, 
{ COMM_EN_DRI VER , 0, 0, 
{ COMM_HY_DRI VER , 0,0, 
{ COMM_HY_DRI VER , 0, 0, 
{ COMM_FDDI_DRIVER , 0, 0, 
{ COMM_FDDI_DRIVER , 



} 



t 



Driver 



0, 0, 

tt 

ios I 

IOP 

not used 



= { 

devtype , lpath , 
0x10, COMM_EN, 
0x11, COMM_EN, 
0x12, COMM_EN, 
0x13, COMM_EN, 
0x0, COMM_N400, 
0x1, COMM_N400, 
0x20, COMM_FDDI, 
0x21, COMM_FDDI, 



devword * / 



t 



Device type 



0, 


0}, 


0, 


0}, 


o, 


0} , 


o, 


0}, 


4, 


0}, 


4, 


0}, 


0, 


0}, 


0, 
i 


0}, 

t 




Device- 




dependent 




not used 



Channel = base + ordinal (in Hex) 

* HYPERchannel 

- Base address is 0x00 

- Two interfaces maximum 

- Valid addresses are 0x00 and 0x01 

* Ethernet 

- Base address is 0x10 

- Four interfaces maximum 

- Valid addresses are 0x10 and 0x1 1, 0x12, 0x13 

* FDDI 

- Base address is 0x20 

- Two interfaces maximum 

- Valid addresses are 0x20 and 0x21 



Logical paths 

- HYPERchannel = 4 

- Not used for Ethernet 
or FDDI (use 0) 



Figure 9. The comm_inf o structure 



Determing the 
interface name 

F.2 



It is important that you know how the interface name is formed, 
because this name is referenced in the configuration files and 
commands that are used to assign the Internet address, map the 
hardware address, and enable the interface. 

The interface name consists of two parts. The first part, the 
prefix of the interface name, is used to indicate the type of 
hardware (specifically, the type of driver). The second part, the 
number of the interface name, identifies the entry in the 
comm info structure. 
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On CRAY Y-MP EL systems the following prefixes are used: 



Prefix 


Type of hardware 


en 


Ethernet interface 


fddi 


FDDI interface 


hy 


HYPERchannel interface 


hsx 


HIPPI interface 


lo 


Loopback interface 



The interface number is determined by the ordinal position of 
the entry (relative to the other entries for the same type of 
driver) in the comm_inf o structure. For example, the first 
Ethernet interface entry in the comm_inf o is enO, the second 
Ethernet interface entry is enl. See the examples in Figure 10. 



struct conun_info coiraninf o [ ] 


= { 










/* drv, iso, iop, 


chan, 


devtype, lpath, devword */ 




{ COMM_EN_DRIVER , 


0, 0, 


0x10, 


COMM_EN, 


0, 


0}, 


enO 


{ C OMM_EN_DR I VER , 


0, 0, 


0x11, 


COMM_EN, 


0, 


0}, 


enl 


{ COMM_EN_DRIVER , 


0, 0, 


0x12, 


COMM_EN, 


0, 


0}, 


en2 


{ COMM_EN_DRIVER , 


0, 0, 


0x13, 


COMM_EN, 


0, 


0}, 


en3 


{ COMM_HY_DRIVER , 


0, 0, 


0x0, 


COMM_N400, 


4, 


0}, 


hyO 


{ COMM_HY_DRI VER , 


0, 0, 


0x1, 


COMM_N400, 


4, 


0}, 


hyl 


{ COMM_FDDI_DRI VER , 


0, 0, 


, 0x2 0, 


COMM_FDDI , 


o, 


0}, 


fddiO 


{ COMM_FDDI_DRI VER , 


0, 0, 


, 0x21, 


COMM_FDDI , 


0, 


0}, 


fddil 


}; 










Examples 


/ 



Figure 10. Examples of interface entry numbers 
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The UNICOS configuration menu system {the menu system) 
provides a menu-driven interface for configuring and 
maintaining UNICOS on CRAY Y-MP EL systems. 



Note 

You cannot use the menu system for installing UNICOS on a 
CRAY Y-MP EL system, but once UNICOS is successfully 
installed, you can use the menu system for configuration and 
system maintenance. 



The menu system includes the following functions: 

• Controls media access 

• Converts old structures to new ones 

• Imports existing UNICOS configuration information into the 
menu system configuration database 

The menu system also provides ease-of-use features such as 
context-sensitive input checking and online help, among others. 



Menu Screens ^ ne menu system divides your screen into several areas, 

G displaying a different type of information in each area. Figure 

10 shows the way a screen is divided. After the figure, each of 
the screen information areas is described. 
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r 



Menu title 



P 
r 

o 
m 

P 

t 

c 
o 

I 

u 
m 
n 



Menu selections 



Keys: 



Definitions 



Prompt window 



Selection-list values 



Advisory message 



Record/page counter 



Error messages 



Figure 10. Menu system screen information areas 

The screen information areas shown in Figure 10 contain the 
following types of information: 

Area Contents 

Menu title Contains the title of this menu. 

Prompt column 

Contains the prompt, showing you the menu item 
ready to be selected and its type. 

Menu selections 

Displays the items in this menu, one per line. 

Key definitions 

Shows available keys for the current menu or 
selection. (For more information about these keys 
see the subsections describing menu system keys 
on pages 128 through 132.) 
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Area Contents 

Prompt window 

Displays prompts for information you must enter. 

Selection-list values 

Displays one of the following when you are in input 
mode on a selection line: 

• A list of the permissible values if the number is 
limited 

• The message Any non-white-space input 
value allowed if only strings without spaces 
are allowed (usually for UNICOS path names, file 
names, and so on) 

• The message Any input value allowed if 
the number of permissible values is very large 

Advisory message 

Displays informational messages that the menu 
system issues. 

Record/page counter 

Shows the record to which the prompt currently 
points and the total number of records in a menu. 
It is displayed only when you are in a menu of 
record lines. 

This line also shows the page number and total 
number of pages, when you are in a multipage 
menu. 

Error messages 

Displays error messages that the menu system 
issues. 



Terminology 

G.2 



You should become familiar with the following terms when 
reading this section: 

Term Definition 

action A menu item that executes a program. The A-> 

prompt indicates actions. 

form list A screen representation of the record lines that 
make up a configuration file. 
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Term 



Definition 



menu 



record line 



A menu item that leads to another menu, one level 
down in the menu tree structure. (See Figure 11, 
page 135, for a diagram of the menu tree.) The 
M-> prompt indicates menus. 

One line of a configuration file, consisting of one or 
more fields of information. 



selection A menu item that is a configuration parameter 
that has an associated value. The S-> prompt 
indicates selections. 



selection list A menu that contains only selection items. 



Menu selections '^ ie ma i n body of the screen (Menu selections in Figure 10, page 

0_ 3 124) displays one menu at a time from the menu hierarchy. It is 

identified by the menu title, which is centered at the top of the 

screen. 

A menu is divided into multiple pages (screens) if all of the 
entries cannot fit on one screen. The \+\ and 0 keys, defined in 
"General menu keys," page 128, let users scroll through 
multipage menus. 

The menus in the menu hierarchy are organized by product in a 
top-down fashion. Items contained in most menus are listed 
according to the order in which you will likely use them: first 
submenus, then selections, and then actions at the bottom of the 
menu. 

Two distinct menu types exist. One permits rapid navigation of 
the menu system, the other permits modification of 
configuration files. The first type of menu organizes its items 
into three separate groups: menus, selections, and actions. This 
type of menu lets users navigate the menu hierarchy quickly by 
having all of the submenu definitions near the top of each menu. 
After a user locates a specific menu, the user can modify the 
selection values displayed or execute an action to perform an 
installation task. The prompts M->, S->, or A-> identify this 
type of menu. 
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The second type of menu contains only form-list items. This 
type of menu lets users manipulate individual configuration-file 
entries (called record lines). The E-> prompt identifies this type 
of menu. 



Menu prompts The prompts of the menu system indicate the type of a menu 

q 4 A item and what you can do with it. The following are the 

available prompts and their meanings: 

Prompt Meaning 

A-> Indicates an item of type action. The line specifies 

the action taken when you press 1 return! on this line. 
Items that end with . . . are of type action. 

E-> Indicates a record line of a configuration file (one line 

of a form-list screen). Pressing I return! on this line 
places you in a selection list for the record line, where 
you can change the values of the fields. 

M-> Indicates an item of type menu. Pressing 

I return! on this line places you in the indicated menu 
one level lower in the menu hierarchy. (Figure 11, 
page 135, shows the top three levels of menus.) Menu 
selections that end with ==> are of type menu. 

N/A Indicates a menu item that is either not applicable for 

the current step or not enabled. 

S-> Indicates an item of type selection. The line is a 

configuration parameter that requires a value. 
Pressing | return! at this prompt places the cursor in 
the value field, in input mode (see "Input keys," page 
130). 

The following is a common sequence of actions (based on these 
prompts as identifiers): 

1. Go to a menu (press I return! at an M-> prompt) 

2. Change the value of a selection (press I return! at an S-> 
prompt) 

3. Perform an action (press I return! at an A- > prompt) 
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General menu keys Th e m enu system supports some general-use keys that are 
q 5 * available (active) in most screens. These keys (either uppercase 

or lowercase) perform the following actions: 

Key Action 

I return I Depending on where you are located, performs the 
following functions: 

• At an A-> prompt, it initiates the action. (Usually 
this means invoking a program.) 

• At an M-> prompt, it moves you to the menu listed. 

• At an S-> prompt, it moves the cursor to the value 
field and puts you in input mode to enter a value. 

• In input mode, it saves the value entered and 
returns the cursor to the prompt column at the left 
of the screen (if the value is valid; otherwise, it 
beeps and issues a message). 

[h] Displays online help for the menu screen in which 

you are currently working. 

This key is displayed only when online help 
information is available for the current screen. 



[v] Accesses either the Docview online help system or 

online man pages (man(l) command). 

[7] Shows a list of the valid inputs you can enter for 

menu items of type selection. 

[w] Displays the path through the menu hierarchy that 

you have traversed. This helps you to remember 
where a particular menu is located in the menu 
hierarchy. You can use this key to determine the 
context of a menu accessed from two or more paths. 

Is pace | Toggles through a list of predefined values for a 

selection if such a list exists (when the cursor is in 
the prompt column at the left of a menu). The [>] key 
also does this. 

\q\ Quits the menu system after asking you whether this 

is really what you want to do. 

| CONTROL^ 

Redraws the screen. 
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Key Action 

0 Escapes to a shell. The type of shell is specified in 

the Preferences menu. 



I CONTROL -71 

Displays menu commands that are currently 
available and valid selections if the current menu 
item is a selection. AMPEX terminals use 
IcoNTROL-SHiFTj (Control-shift-underscore). 

(<] Selects previous selection-list value, (opposite of [>]) 



G.6 



Movement keys The menu system provides the following keys for you to use in 

moving around the menu hierarchy and within individual 
menus. (See Figure 11, page 135, which shows the first three 
levels of menus.) 

Key Movement 

[m] Returns you to the initial main menu screen. 

|e| Returns you to the previous menu, one level up the 

menu hierarchy. 

IreturnI At the M-> prompt, moves you one level down the 
menu hierarchy. 

\+\ Moves you to the next screen of a multiscreen menu. 

This is displayed only when the menu is more than 
one screen. 

□ Moves you to the previous screen of a multiscreen 

menu. This is displayed only when the menu is 
more than one screen. 

\tab\ Moves you down to the next line of the menu. If you 

are on the last item in the menu, this wraps to the 
top. You can also use the [j] key (as in the vi editor) 
or [control- 1 1 to perform this function. 

I backs pace | Moves you up to the previous line of the menu. If 
you are on the first item in the menu, this wraps to 
the bottom. You can also use the lowercase \k\ key 
(as in the vi editor) or 1 control -h] to perform this 
function. 
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To change the value of a selection item in a menu, use one of 
the input keys. These keys are set to emulate the functions of 
one of the text editors vi or emacs, which you choose in the 
Preferences menu. Table 6 describes the available keys. 

Table 6. Input keys 



vi key emacs key Action 

□ or \g\ | control -a] Moves cursor to beginning of input buffer. 

[H] or |control-b1 Moves cursor backward one character (nondestructive). 

| CONTROL -~Hl 

[x] 1control-d1 Deletes the character on which the cursor is located. 

H] 1 control -e1 Moves cursor to end of input buffer. 

CO or | space | | control -f] Moves cursor forward one character (nondestructive), 

[x] I control -h1 or Deletes previous character (to left of cursor). 

| DELETE | 

[p] | control -k1 Deletes from current cursor location to end-of-line. 

1 control -ul I control -Ul Deletes entire input line. 

[tab | or \>\ | tab I Gets next selection value (toggle). 1 control -i\ also performs 

this action. 

[<] Gets previous selection value (toggle). 

\t\ Inserts new text to left of cursor. 

[a] Appends new text to right of cursor. 

[a] Appends new text to end of input buffer. 

[i] Inserts new text at beginning of input buffer. 

[D Replaces the character under the cursor with input text until 

| ESCAPE 1 . 

[s] or [cc] Replaces the entire line with input text until | escape I . 

\c\ or [c$] Replaces from cursor position to end-of-line with input text 

until [escape]. 

[r] Replaces character on which cursor is located. 

\r\ Replaces existing characters by overstriking them; ends with 

I escape | . 

1 return! I return I Verifies current input and accepts it, if valid. 

|u] Undoes all changes, restoring original value. 

\u\ Undoes last editing change. 
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Table 6. Input keys (continued) 



vi key 


emacs key 


Action 


|control-l| 


I CONTROL -L| 


Redraws screen. 


|CONTROL-?| 


|CONTROL-?| 


Displays active keys. 


I DELETE | 




Moves cursor backward one character (nondestructive). 
Used only when in insert, append, or replace mode. 


| ESCAPE | 




Terminates input, append, or replace modes, returning you 
to command mode. 



Accelerator keys r ^ [le keys described in this subsection provide time-saving 

q g * shortcuts for moving around in the menu hierarchy. As a handy 

reminder, the I control-"?] key displays the accelerator keys you 

have already defined. 

Key Description 

[a] Assigns the current location in the menu hierarchy to 

one of the keys [T] through [§]. 

I escape [n]| 

Traverses the menu system to get to the menu defined 
by assign key n. If you specify 0 for n, the previous 
menu is displayed, allowing you to toggle between two 
menu locations anywhere in the hierarchy of menus. 



Form-list keys When you are in a form list (indicated by the E-> prompt), you 

q * can search for, add, delete, copy, and move lines in the list. The 

form-list editing keys are as follows: 

Key Action 

\d\ Deletes the current line. 

0 Creates a new line, with default values in the fields, 
after the current line. 

[n] Creates a new line, with default values in the fields, 
before the current line. 
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Key Action 

H Puts a yanked or deleted line after the current line. 

[p] Puts a yanked or deleted line before the current line. 

[i] Requests a string or regular expression and searches the 
form list for it. You can also use [7] for this (as in the vi 
editor). 

H] Repeats the last search. 

[u] Edits the current form list by using the editor specified 
in the preference menu. 

Use this feature with caution; do not alter record fields 
that should not be modified. 

[y] Copies the current line into a buffer for later use (like 
the vi editor "yank" (y) command). 

[?] Searches backward for specified expression (opposite of 

0). - 

□ Displays the first column of the current form list. You 
can also use [o]. 

[$] Displays the last column of the current form list. 

[<0 Displays the previous column of the current form list. 

\>\ Displays the next column of the current form list. 



Record-line keys Each line of a form-list screen is called a record line. A record 

G * line is a line from a file (usually a configuration file) that is 

being parsed by the menu system for display (but that cannot be 
edited). With the cursor on a record line, pressing I return I moves 
you to a selection list, which is an editable list of all fields that 
make up a record line. 
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In a selection list, you can use the following keys to change a 
fields' value: 

Key Action 

Input keys You can use all input keys described in "Input 
keys," page 130. 

\f\ Moves you forward one record line so that you do 

not have to return to the form-list screen, one menu 
level up. The [f] key also performs this function. 

[|] Moves you backward one record line so that you do 

not have to return to the form-list screen, one menu 
level up. The [b] key also performs this function. 



Log file Th e menu system keeps a log file of configuration actions, 

including any errors or problems. Use the following menu 
sequence to examine this file: 

UNICOS 7.0 Installation / Configuration Menu System 
Utilities ==> 

Inspect the installation log. . . 

To examine the log file outside of the menu system, look at the 
install . log file in the installation directory. 
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The menu system recognizes several different types of numbers. 
Table 7 shows the correct format you must use when entering 
numbers. 



Table 7. Numeric types in the menu system 



Number type 


Description 


Examples 


Floating point 


Starts with an optional minus sign, followed by one or 
more digits [0-9] appearing on either side or both sides 
of the decimal. 


-.3 6. 3.45 


Hexadecimal 


Starts with OX or Ox, followed by one or more digits 
[0-9] or letters [a-f A-F]. 


0X7A 0x35 Oxfff 


Octal 


Starts with a 0, followed by one or more digits [0-7]. 
Octal 0 is represented by two consecutive 0's. 


045 07777 00 


Integer 


Starts with an optional minus sign, followed by one or 
more digits [0-9]. 


-456 0 6999 



Signal processing 

G.13 



The menu system traps the UNICOS SIGQUIT signal, gracefully 
exiting. It ignores UNICOS signals SIGINT and SIGTERM. 

The SIGINT, SIGQUIT, and SIGTERM signals are reset to 
SIG_DFL when a program is executed from inmenu, letting that 
program decide whether certain signals should be ignored. 



Note 



The menu system traps the SIGQUIT signal, commencing an 
orderly shutdown and immediate exit, with an error code of 9 
and the message Program terminated by the user 
entering a SIGQUIT signal. 
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Top three menu 
levels 

G.14 



Release 
media 

management 



Load 

UNICOS 

products 



To help you visualize your position when using the menu 
system, Figure 11 shows the top three levels of the UNICOS 
installation and configuration menu system. 



UNICOS 7.0 configuration menu system 



Configure 
system 




- IOS 



Configurator 

automation 

options 



Major 
software 



Mainframe 

hardware 

configuration 



Kernel 



MLS 
security 



Disks 



Special 
system device 
configuration 



File system 



— Tapes 



(continued) 



Build/Install 
system * 



Build 
options 



Major 

components 



Restart 
build 



Utilities 



File 

transfer 
utilities 




Conversion 
utility 



Import 
utility 



Activation 
utility 



Preferences 



UNICOS kernel builds only 



Figure 11. Top three levels of the menu system 
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- Network 



- NQS 



Cray 

REELlibrarian 



System 
daemons 



Startup 

(/etc/rc) 



Accounting 
configuration 



Compiler 
configuration 



SEGLDR loader 
configuration 



Miscellaneous 
software 



Figure 11. Top three levels of the menu system (continued) 
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The attached appendix H, "Disk Flaw Handling," was new with 
the UNICOS 7.0.4.2 update package. If you did not receive the 
UNICOS 7.0.4.2 update package, please insert this appendix into 
your copy of the UNICOS Installation Guide for CRAY Y-MP EL 
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This appendix describes how to prepare ESDI and IPI drives for 
using the new disk flaw handling utilities and shows examples of 
using the dsurf and dslip utilities for disk flaw handling. 

The new disk flaw handling feature makes flaw management 
much simpler than was possible using previous releases. After 
your have prepared the drives for disk flaw handling, the 
software will automatically save all flaw information. This flaw 
information can then be used on subsequent formats (if desired), 
so that no flawing information is lost. 

The following changes were made to support the new disk flaw 
handling capability: 

• A dsurf utility was added to provide a more flexible method of 
performing disk surface analysis. It can perform read-only 
tests or pattern write and read tests. 

• The df ormat utility was updated to use the saved flaw 
information. New options are -1 level, -s serial 
number, and -f file. 

• The df ormat utility no longer performs a dverif y for IPI 
drives. 

• The dslip utility was updated; the new dslip C : syntax 
allows blocks to be slipped on a IOS SCSI disk. 

• The df lawr utility has a new -r option that will read the 
sector IDs on IPI and ESDI drives to report the sectors and 
tracks that have actually been slipped and mapped on the 
drive. Additional new options are -f file, -1, and -s. 

• The dflaww utility has the new options dflaww E (for ESDI 
disks), dflaww I (for IPI disks), and-f file. 

The new dsurf and revised df ormat, dslip, df lawr, and 
dflaww man pages are provided online only; a printed version of 
these man pages is not provided. 
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The following terms are used in this appendix: 



Term 

Growth Error Table (GET) 



OEM defect list 



Description 

This table shows all known flaws on 
the drive. For the IPI and ESDI 
disks, this table includes the OEM 
defect list, along with all flaws 
slipped and mapped by the user. 

This list shows all flaws found by 
the drive manufacturer; this list is 
permanently stored on the disk. 



Preparing disks 
for flaw handling 

H.1 



This subsection describes how to prepare ESDI and IPI drives for 
using the new disk flaw handling utilities. 



ESDI disks 
(DD-2 and DD-3) 
H.1.1 



To prepare ESDI drives for using the new disk flaw handling 
utilities, you must do one of the following: 

• Format the drive by using df ormat and the -12 option, as 
follows: 

df ormat E00 -1 2 -s <serial number of drive> 

• Run df lawr by using the -r option and write the GET read 
from the drive to a file, as follows: 

dflawr E00 -r -s <serial number> 

Then run df laww to write the GET to the disk, as follows: 

dflaww E00 



Note 

When running the dflawr utility with the -r option on ESDI 
drives, the flaw block numbers found in the GET list may not 
always match the OEM list. 
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IPI disks (DD-4) lb prepare IPI drives for using the new disk flaw handling 

H.1.2 utilities, you must do one of the following: 

• Format the drive by using df ormat and the -12 option, as 
follows: 

df ormat 100 -1 2 -s <serial number of drive> 

• Run df lawr by using the -r option, and write the GET read 
from the drive to a file, as follows: 

dflawr 100 -r -s <serial number> 

Then run df laww to write the GET to the disk, as follows: 

dflaww 100 



Examples 

H.2 



This subsection shows examples of using the dsurf and dslip 
utilities for disk flaw handling. 



dsurf utility 
H.2.1 



The dsurf utility has the following syntax: 

dsurf C: [-adfirv] [-n blocks] [-p passes] [-s start] 

dsurf Ecd [-adfirvw] [-1 level] [-n blocks] [-p passes] 
[-s start] [-t count] 

dsurf led [-adfirvw] [-1 level] [-n blocks] [-p passes] 
[-s start] [-t count] 

Option Description 

-a Ask before flawing; default is to flaw silently, 

-d Debug on; errors will not be flawed, 

-f Run test until one pass completes without an error, 

-i Inhibit recheck on flawed errors. 
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Option Description 

-1 Test level: 

0 Read Test (Default) 

1 Eight-pattern write/read 

2 Four-pattern random write/read 

-n Number of blocks to test; default is entire disk, 

-p Number of passes to run; default is 1. 

-r Do not flaw errors; default is to flaw. 

- s Start block; default is 0 . 

-t Read/write I/O size in sectors; default is one track, 

-v Verbose. 

-w Allow writing without prompting; default is to 
prompt before writing. 



The following example performs a read of the entire ESDI disk, 
slipping/mapping any bad sectors found: 

IOS>dsurf E00 

The following example performs an eight-pattern write/read on 
the entire IPI disk and runs until no errors are found in a pass: 

IOS>dsurf 100 -vfl 1 

The following example performs a read-only test starting at 
block 32500 and reading until the end of the disk. The test does 
five passes and prompts the user to verify before 
slipping/mapping: 

IOS>dsurf E00 -avp 5 -s 32500 

The following example performs a read-only test of the entire 
IOS SCSI disk, slipping/mapping any defects found: 

IOS>dsurf C: 



dslip utility The dslip utility has the following syntax: 

H 2 2 

dslip C: sector 
dslip Ecd sector 
dslip led sector 
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The following example slips block 32456 on the IPI drive: 

IOS>dslip 101 32456 
The following example slips block 3456 on the IOS SCSI disk: 

IOS>dslip C: 3456 

Note 

The block number given by the df lawr utility for the IOS SCSI 
disk is a physical block number, which may not be the same as 
the logical block number given to the dslip utility. 
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Your reactions to this manual will help us provide you with better documentation. Please take a moment to 
complete the following items, and use the blank space for additional comments. 

List the operating systems and programming languages you have used and the years of experience with 
each. 



Your experience with Cray Research computer systems: 



_0-l year 



.1-5 year 



_5+years 



How did you use this manual: in a class as a tutorial or introduction as a procedural guide 

as a reference for troubleshooting other 



Please rate this manual on the following criteria: 
Accuracy 

Appropriateness (correct technical level) 
Accessibility (ease of finding information) 
Physical qualities (binding, printing, illustrations) 
Terminology (correct, consistent, and clear) 
Number of examples 
Quality of examples 
Index 



Excellent 
4 
4 
4 
4 
4 
4 
4 
4 



Poor 
1 
1 
1 
1 
1 
1 
1 
1 



Please use the space below for your comments about this manual. Please include general comments about 
the usefulness of this manual. If you have discovered inaccuracies or omissions, please specify the number 
of the page on which the problem occurred. 
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Zip code 
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